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

{
  "type":"page",
  "timestamp":"2019-05-09T00:14:36.138Z",
  "context":{
    "destination_id":"bc14d411-9a42-46b7-9768-b2b47748a4a8",
    "segment_id":"321f1407-1a13-4f5b-82dd-f8b0ac8b4c7b",
    "segment_name":"andrew",
    "segment_type":"company"
  },
  "body":{
    "company":{
      "domain":"kqed.org",
      "name":"KQED",
      "legal_name":"KQED INC",
      "employees":550,
      "employees_range":"251-1K",
      "revenue":null,
      "revenue_range":"$50M-$100M",
      "twitter":"KQED",
      "github":null,
      "linkedin":"company/kqed",
      "facebook":"kqed",
      "geo_state_code":"CA",
      "geo_country_code":"US"
    },
    "last_visit_host":"clearbit.com",
    "last_visit_path":"/jobs",
    "last_visit_at":"2019-05-09T00:03:05.576Z",
    "last_visit_paths":[
      {
        "host":"clearbit.com",
        "path":"/jobs",
        "timestamp":"2019-05-09 00:03:05 UTC"
      },
      {
        "host":"clearbit.com",
        "path":"/",
        "timestamp":"2019-05-09 00:03:08 UTC"
      },
      {
        "host":"clearbit.com",
        "path":"/jobs",
        "timestamp":"2019-05-08 23:51:27 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

 

What's next?

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