Webhook syncs

Updated by Andreea Mahu

What can you do with Webhook syncs?

You can use Webhooks to send company or contact audience data to multiple tools and APIs for which we do not have a native integration yet, such as Zapier, n8n or Clay. The format the data will be shared in is JSON. You can build audiences using relevant signals in Dreamdata and sync them to the outreach tool that you use to create automated workflows to reach out to relevant companies/contacts (enrichment tools may be needed).

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 - companies 
{

          "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"

              }

            ]

          }

          }

The data that will be synced for each contact represents:

  • Contact name, email, country, title, role, seniority
  • Companies the contact belongs to
Data structure JSON - contacts 
{

          "metadata": {

            "message_id": "string",

            "sent_at": "timestamp",

            "audience": {

              "name": "string",

              "id": "string",

              "type": "string"

            }

          },

          "data": {

            "dd_contact_id": "string",

            "email": "string",

            "custom_properties": {},

            "properties": {

              "additional_emails": ["string"],

              "first_name": "string",

              "country": "string",

              "last_name": "string",

              "name": "string",

              "is_corporate_email": boolean,

              "is_from_primary_crm": boolean,

              "phone_number": "string",

              "role": "string",

              "seniority": "string",

              "title": "string",

            },

           "companies": {

              "dd_company_id": "string",

              "domain": "string",

              "is_primary_company": "string",

              "name": "string",

            },

           "source_system": [

                {

                  "id": "string",

                  "source": "string",

                  "object": "string"

                }

              ]

          }

          }
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 or contacts), 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 or contact 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 🔥 All existing data from the selected audience will be synced immediately. Following each data modeling run, data will be automatically synced daily, for any additions in the selected audience (updates to records already synced are not included).

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

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 or contact 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

n8n

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

Dreamdata integrates with n8n 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 trigger workflow automation based on the data received

Setup required
  1. Login to n8n
    1. You need an active account
    2. Create a Webhook node by following this guide
    3. Find the Production Webhook URL
  2. Create a Webhook connection in Dreamdata - through the n8n page or Webhooks
    1. Copy the Webhook URL from n8n
    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?