Webhook

Last updated on Oct 31, 2023

We have migrated our webhooks infrastructure for better scalability and throughput. As a result, the old Webhook URLs are deprecated and will stop working soon. Please migrate to the new webhook URL (provided in the Set up Webhook section of your Pipeline Overview page) to avoid disruption in your data loading operations.

new webhook notice

You can use Webhook to push data from your Source to Hevo in real-time. The Hevo Pipeline then replicates this data to your Destination database or data warehouse.

A Webhook-based Pipeline is useful when new data is actively generated in your Source. Instead of Hevo checking for updates at specific intervals, you can configure the URL provided by your Webhook Pipeline in the application and directly send the data to Hevo as soon as it is generated. You can also configure your Webhook Pipeline using the Hevo API and send one or more files up to 16 MB each in an API call.


Prerequisites


Configure your Webhook Source

Perform the following steps to configure Webhook as the Source in your Pipeline:

  1. Click PIPELINES in the Navigation Bar.

  2. Click + CREATE in the Pipelines List View.

  3. In the Select Source Type page, select Webhook.

  4. In the Configure your Webhook Source page, specify the following:

    Source Config Image

    • Pipeline Name: A unique name for your Pipeline, not exceeding 255 characters.

    • Event Name Path: The path to the field from which data should be retrieved. For example, eventName.

    • Fields Path: The path to the field from where you want to retrieve data from. For example, properties.

      For example, in the sample event below the Event Name Path is eventName and Fields Path is properties:

      
      curl --location --request POST 'https://asia-webhook.hevo.io/t/qnxaukssoq' \
      --header 'Content-Type: application/json' \
      --data-raw '{
        "eventName": "payment.authorized",
        "properties": {
              "id": "pay_DESlfW9H8K9uqM",
              "entity": "payment",
              "amount": 100,
              "currency": "INR",
              "status": "authorized",
              "order_id": "order_DESlLckIVRkHWj"
      
        }
      }'
      
    • Advanced Settings:

      • Basic Authentication: The method by which your Source authenticates Hevo.

        • If disabled, the Events are pushed from your Source to Hevo without any authentication. After creating the Pipeline, Hevo provides you with a Webhook URL. Use this URL in the application from which you want to push data to Hevo. To use this option, click CONTINUE and proceed to configuring your Destination.

          No Authentication

        • If enabled, the Events are securely pushed from your Source to Hevo using an API key. To create the API key, perform the following steps:

          1. Click + NEW API KEY.

            New API key

          2. In the API KEY pop-up window that appears, click the Copy icon corresponding to the Access Key and Secret Key to copy and save them securely like any other password. Alternatively, you can click DOWNLOAD to download the keys in a JSON file.

            Copy API key

          3. Click CONTINUE to proceed to configuring your Destination.

            Configuring Destination

          4. After creating the Pipeline, Hevo provides you with a Webhook URL and Access Key. Specify the URL, access key, and secret key that you saved in the application from which you want to push data to Hevo.

            URL and Access key


Source Considerations

  • Webhook only supports JSON files up to 16 MB in size.

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Sep-07-2023 NA Added section, Source Considerations.
Mar-16-2023 NA Updated the page overview to add information about file size in an API call.
Mar-09-2023 2.09 - Updated section, Configure your Webhook Source to add information about the toggle option to enable or disable Basic Authentication.
Dec-19-2022 2.04 Added information about support for the Basic Authentication method to securely send data to Hevo.

Tell us what went wrong