Webhook Destination

Our Webhook Destination allows you to send segment matches anywhere you need to.

When enabled, Clearbit X 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

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

Common use cases include - 

Enabling

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

Screen_Shot_2019-04-24_at_7.52.10_AM.png

 

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 X 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.

Screen_Shot_2019-05-25_at_4.35.55_PM.png

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

Screen_Shot_2019-09-20_at_8.55.37_PM.png

What's next?

If you've already setup a destination, check out some example segments for more ideas on how to use Clearbit X!