Webhook syncs

Updated by Andreea Mahu

What can you do with Webhook syncs?

You can use Webhooks to send audience data to multiple tools and APIs, such as Zapier or Clay, for which we do not have a native integration yet. The format the data will be shared in is JSON.

Data structure

The data that will be synced for each company represents:

  • Company name, domains, country, industry, number of employees
  • Account owner name and email
  • Engagement score and signals for the last 30 days
Data structure JSON 
{

          "metadata": {

            "message_id": "string",

            "sent_at": "timestamp",

            "audience": {

              "name": "string",

              "id": "string",

              "type": "string"

            }

          },

          "data": {

            "dd_company_id": "string",

            "domain": "string",

            "all_domains": ["string"],

            "account_owner": {

              "email": "string",

              "name": "string"

            },

            "custom_properties": {},

            "properties": {

              "name": "string",

              "country": "string",

              "industry": "string",

              "number_of_employees": "string",

              "engagement_score": "float",

              "source_system": [

                {

                  "id": "string",

                  "source": "string",

                  "object": "string"

                }

              ]

            },

            "signals": [

              {

                "names": ["signal1", "signal2"],

                "window": "last_30_days"

              }

            ]

          }

          }
Any of the sync destinations that have the Via Webhooks label can be used with the setup presented below.

How to set up Webhooks?

  1. On Dreamdata's main menu, navigate to Activation Hub -> Syncs and select Webhooks.
  2. Click the Add new button to start creating a Webhook connection.
  3. Choose a title for your sync and an Audience (companies), add the URL for the Webhook you want to use, and click Save (depending on your setup, you may need to use the header fields as well).
    1. If you want to test the connection, after adding the Webhook URL, click the Send data test button. You will receive one company record in the selected Webhook URL.
  4. You will be able to see a list with all your saved Webhook syncs and some properties:
    In this view, you can disable, enable, edit and delete syncs.
  5. You're all set 🔥 data will be automatically synced daily, following each data modeling run, for any additions in the selected audience.

Clay

Send audience data to Clay via Webhooks.



Dreamdata integrates with Clay through Webhooks, allowing you to easily send over audience data. This integration enables you to enrich your Clay tables with company data collected in Dreamdata and trigger workflow automation based on the data received

Setup required
  1. Login to Clay
    1. You need an account with Webhook functionality
    2. Create a Webhook by following this guide
    3. Find the Webhook URL
  2. Create a Webhook connection in Dreamdata - through the Clay page or Webhooks
    1. Copy the Webhook URL from Clay
    2. Paste the URL into the Dreamdata Webhook configurator
    3. Test the connection using the “Send data test” button
    4. Save your setup

Zapier

Send audience data to Zapier via Webhooks if you want to use your data in a destination we do not yet support.

Dreamdata integrates with Zapier through Webhooks, allowing you to easily send over audience data. This integration enables you to send audience data to other system that we do not integrate with and trigger workflow automation based on the data received.

Setup required
  1. Login to Zapier
    1. You need an active account
    2. Create a Zap
      1. Use “Webhook by Zapier” as the trigger
      2. Use “Catch Hook” as the trigger event
    3. Find the Webhook URL
  2. Create a Webhook connection in Dreamdata - through the Zapier page or Webhooks
    1. Copy the Webhook URL from Zapier
    2. Paste the URL into the Dreamdata webhook configurator
    3. Test the connection using the “Send data test” button
    4. Save your setup

How did we do?