Use a Webhook Destination

Our Webhook Destination allows you to send segment matches anywhere you need to. When enabled, Clearbit will post a JSON payload to the URL you specify. The payload includes data about the company/person that matched as well as metadata about the destination and segment.

Example JSON Payload

📝 Please note: While the format will be the same, the attributes available will differ depending on which you choose to include.

"context": {
  "destination_id": "ID",
  "segment_id":"ID",
  "segment_name":"Test Segment",
  "segment_type":"company",
  "timestamp":"2019-09-20T23:12:49.679+00:00",
  "trigger":"segment_enter"
},
"company": {
  "domain":"clearbit.com",
  "name":"Clearbit",
  "logo":"https://logo.clearbit.com/clearbit.com",
  "enrichment": {
    "name":"Clearbit",
    "domain":"clearbit.com",
    "metrics": {
      "employees_range":"51-250"
    }
  },
  "traits": {
    "paid":true,
  },
  "events": {
    "page_views":[
      {"host":"clearbit.com",
      "path":"/reveal-demo",
      "timestamp":"2019-09-20 23:10:10 UTC"
      },
      {"host":"clearbit.com",
      "path":"/customers/frameio",
      "timestamp":"2019-09-20 23:02:15 UTC"}
    ]
  }
}

Enabling

The Webhook destination can be enabled from the Destinations tab of any segment.

Settings

Trigger - Sets the criteria for a person/company to trigger the destination. The options are:

• Page view - Triggers every time company/person views a page on your site.
• Segment enter - Triggers only when a company/person enters the segment.
• Segment exit - Triggers only when a company/person exits the segment.

URL - The URL you want Clearbit to send the JSON payload to.

Suppression settings - When enabled, excludes people/companies that you've been alerted to within the past x days/weeks/months. In the image below, a company would only trigger the Destination if they haven't triggered one in the past 5 days.

Customize the Webhook - Allows you to specify exactly which attributes you want to send via webhook.