Legacy: Integrate Clearbit Enrichment with Segment

Last Updated: September 25, 2023

🔍 Please note: this article is for customers on Standard Bundle, Enrichment, or Clearbit Platform plans.

With a few clicks, you can automatically add person & company data for all identified users into Segment and fan that data out to all of the 180+ integrations.

Screen_Shot_2017-12-01_at_3.00.33_PM.png

Use cases include:

  • Sync all your users and events to Redshift, then automatically enrich that data with Clearbit. Once that data's in Redshift it's simple to query the data however you'd like, building customer segmentation reports or better understanding the products your customers use with Clearbit's tech tags.
  • Pipe all your users to Customer.io, and then build segments based on Clearbit data. For example, you could use Clearbit's role attribute to send a different drip campaign to customers in sales than those in software engineering.
  • Send data to an analytics provider like Mixpanel, and you'll immediately have fully fleshed-out customer profiles available for even more detailed analysis. The sky's the limit – use Clearbit's data to track conversion rates by industry, for example.
  • You can find some additional awesome ideas here.

How Does it Work?

The Clearbit integration listens to the Segment Identify Event. We'll then take the email associated with the Identify Event, enrich it, and issue another Identify Event. Once that email address has been enriched Clearbit data will be available to any of the integrations you've configured in your Segment source. We will only re-trigger an Identify Event once every 30 days for a particular email.

How Do I Set It Up?

📝 Please note: If you have already added the integration then skip steps 1-3.

  1. Find the Clearbit integration on the Integrations page of your Segment Source in your Segment account (or you can add it to your Segment account from the integration's landing page).
  2. Add your account's Secret Clearbit API Key to the Settings page of the Clearbit Integration in Segment.
  3. Click Save Changes and Enable Integration.
  4. Verify that the integration is working correctly by checking the Debugger section of your Segment Source. If everything has been set up correctly, you should start seeing Clearbit data populate in the Identify events – click on the specific event you're interested in to see Clearbit traits. These traits will now be available to other Segment integrations in your account. Notice that all Clearbit traits are prefixed with clearbit_ to ensure they don't conflict with existing traits.
    Screen_Shot_2017-12-01_at_3.03.03_PM.png

💡 Clearbit Tip: By default, the integration will only enrich users identified after the integration is enabled. If you'd like to backfill data you'll need to fire a new identify event in Segment for all existing users you'd like to backfill.

 

Troubleshoot: 

Are you using an EU-based Workspace and not receiving enriched events from Clearbit? 
Our Segment integration uses Segment's U.S. (Oregon) endpoint to send enriched data. This means that if your Segment Workspace is using a different data processing region, you will not see the enriched Identify Events in Segment. We recommend speaking with Segment's Support team to create workspaces in other regions.