How do I set up a Clearbit Webhook in Marketo?

With Marketo’s webhook functionality and our flexible API, you can automatically enrich new leads with valuable information like Total Funding, Employee Count, Location and Social Networks. Better yet, you can be up and running in under 5 minutes.

Step one - Create your custom fields

You are going to need somewhere to put your Clearbit data, so let’s add a few custom fields to your leads. You can map Clearbit data to any existing Marketo field as well, but in case the attribute you are looking for doesn’t have a field by default, follow the steps below to add it. 

Take a look at the list at the bottom of the page, which includes every field that we currently return to Marketo. Most users are only interested in a handfull of attributes, so don't let the long list scare you. You can also always add new fields in later if you'd like.

  1. In Marketo, head to your Admin panel
  2. Browse to Field Management -> New Custom Field
  3. Choose the field type (Pick String for short text fields and Text Area for longer fields, like bios)
  4. Name the field and click CREATE
  5. Repeat for any fields you want to add

Step two - Create a Clearbit webhook

Next, we’ll connect Clearbit to Marketo.

  1. Head to Admin -> Webhooks -> New Webhook
  2. After naming the webhook, enter the following in the URL text area -
    https://person.clearbit.com/v2/combined/find?email={{lead.Email Address:default=email}}
    	
  3. Change Request Type to GET, and Response Type to JSON
  4. Save

Time to add authorization!

  1. Under the Webhook Actions toolbar, select Set Custom Header
  2. Add a new header. Set Header to Authorization and Value to Bearer YOUR_API_KEY (You can grab your Clearbit API Key from https://clearbit.com/keys)

Finally, we’ll map our Clearbit data to the Marketo fields you set up earlier.

  1. Click the Edit button on the Response Mapping box
  2. Click Add
  3. Set Response Attribute to the Clearbit attribute that you want to grab (a full list below), and Marketo Field to the corresponding field that you created in step one
  4. Repeat for each field you want to set up (Helpful Hint: Copy and paste from the attribute columns below)

That's all there is to it.  Check out our doc on triggering webhooks in Marketo for implementation instructions.

Clearbit Attributes

Note: These attributes reflect our most recent api version.
Person Attribute Description
person.name.givenName string First name of person (if found)
person.name.familyName string Last name of person (if found)
person.name.fullName string Full formatted name of person. Sometimes this will be present even if the givenName or familyName aren’t available
person.gender string male or female
person.location string The most accurate location we have
person.geo.city string Normalized city based on location
person.geo.state string Normalized state based on location
person.geo.stateCode string Headquarters two character state code
person.geo.country string Normalized two letter country code based on location
person.geo.countryCode string Headquarters two character country code
person.geo.lat string General latitude based on location
person.geo.lng string General longitude based on location
person.bio string The most accurate bio we have
person.site string The person’s website
person.avatar string The best avatar url we have
person.employment.name string Company name
person.employment.title string Job title
person.employment.domain string Company domain
person.employment.role string Job role
person.employment.seniority string Job seniority
person.facebook.handle string Facebook ID or screen name
person.github.handle string GitHub handle
person.github.id integer GitHub ID
person.github.avatar string GitHub avatar
person.github.company string GitHub company
person.github.blog string GitHub blog url
person.github.followers string Count of GitHub followers
person.github.following string Count of GitHub following
person.twitter.handle string Twitter screen name
person.twitter.id string Twitter ID
person.twitter.followers integer Count of Twitter followers
person.twitter.following integer Count of Twitter friends
person.twitter.location string Twitter location
person.twitter.site string Twitter site
person.twitter.statuses integer Tweet count
person.twitter.favorites integer Favorite count
person.twitter.avatar string HTTP Twitter avatar
person.linkedin.handle string LinkedIn url (i.e. /pub/alex-maccaw/78/929/ab5)
person.googleplus.handle string Google Plus handle.
person.angellist.handle string AngelList handle.
person.angellist.id integer AngelList id.
person.angellist.bio string AngelList bio.
person.angellist.blog string AngelList blog.
person.angellist.site string AngelList site.
person.angellist.followers integer AngelList followers count.
person.angellist.avatar string AngelList avatar url.
person.aboutme.handle string about.me handle
person.aboutme.bio string about.me bio
person.aboutme.avatar string about.me avatar URL
person.gravatar.handle string Gravatar handle.
person.gravatar.urls array Array of URLs from Gravatar.
person.gravatar.avatar string Gravatar main avatar url.
person.gravatar.avatars string Array of objects containing a avatar url, and a type (i.e. thumbnail).
person.fuzzy boolean Indicating whether or not the lookup is a fuzzy or exact search.
company.name string Name of company
company.legalName string Legal name of company
company.domain string Domain of company’s website
company.site.url string URL of company’s website
company.site.title string HTML title contents of company’s website
company.category.sector string Broad sector (e.g. Information Technology)
company.category.industryGroup string Industry group (e.g. Software & Services)
company.category.industry string Industry (e.g. Software)
company.category.subIndustry string Sub industry (e.g. Application Software)
company.description string Description of the company
company.location string Address of company
company.geo.streetNumber string Street number of company address
company.geo.streetName string Street of company address
company.geo.subPremise string Unit number of company address
company.geo.city string City of company address
company.geo.state string State of company address
company.geo.country string Country of company address
company.geo.postalCode string Postal code of company address
company.geo.lat string Latitude of company address
company.geo.lng string Longitude of company address
company.facebook.handle string Company’s Facebook ID
company.facebook.likes integer Company’s Facebook likes
company.linkedin.handle string Company’s Linkedin URL
company.twitter.handle string Twitter screen name
company.twitter.id string Twitter ID
company.twitter.bio string Twitter Bio
company.twitter.followers integer Count of Twitter followers
company.twitter.following integer Count of Twitter friends
company.twitter.location string Twitter location
company.twitter.site string Twitter site
company.twitter.avatar string HTTP Twitter avatar
company.angellist.handle string AngelList handle.
company.angellist.bio string AngelList bio.
company.angellist.blog string AngelList blog.
company.angellist.site string AngelList site.
company.angellist.followers integer AngelList followers count.
company.angellist.avatar string AngelList avatar url.
company.crunchbase.handle string Crunchbase handle
company.logo string SRC of company logo
company.emailProvider boolean is the domain associated with a free email provider (i.e. Gmail)?
company.type string The company’s type, either education, government, nonprofit, private, public, or personal.
company.phone string International headquarters phone number
company.ticker string Stock ticker symbol
company.metrics.employees integer Amount of employees
company.metrics.alexaUsRank integer Alexa’s US site rank
company.metrics.alexaGlobalRank integer Alexa’s global site rank
company.metrics.googleRank integer Google Page Rank of company’s website
company.metrics.marketCap integer Company's market cap
company.metrics.raised integer Total amount raised