Clearbit for HubSpot: Database Enrichment Troubleshooting Guide
If you are experiencing either of the below issues, follow each of the recommended troubleshooting steps.
- New contacts are not getting enriched upon creation
- Backfill or Refresh Enrichment is not enriching existing contacts
Make sure the contacts you are enriching have an email filled into the Email field
If no email is filled into the Email field, then Clearbit's integration will do nothing with the contact.
Make sure you have configured your Clearbit-HubSpot field mappings
You can check your field mappings here. If you do not have any field mappings set up, then no data will be added to your contacts. Here's an example of some completed field mappings.
If you do not have any field mappings configured, click the "Add mapping" button to begin setting them up.
Make sure your Clearbit account is successfully connected to your Hubspot account
You can check this in your Clearbit-HubSpot dashboard here. If your Clearbit account is successfully connected to HubSpot, the connection status will be listed as "Active" with the date the connection was established. If it is not connected, follow the on-screen instructions to re-connect or reach out to firstname.lastname@example.org.
Check if there are any errors in your enrichment activity dashboard
You can see your enrichment activity dashboard here. You may see some contacts labeled with "Unable to enrich". This does not always mean there was an error. If you click on the email and see "Status 404 Not Found", it just means the lookup was successful and Clearbit does not have any data for that email.
If you see any other errors, please screenshot them and reach out to email@example.com so we can investigate for you.
Troubleshooting Clearbit-HubSpot Forms
- The form does not enrich when an email is filled into the Email field
- Form fields do not dynamically appear when Clearbit data is unavailable (assuming you want form shortening)
If you are having either of these issues, check each of the following.
Make sure each of the form fields are included in your Clearbit-HubSpot field mappings
You can check your field mappings here. If a form field is not in your field mappings, then Clearbit will not be able to enrich it. Here's an example of some completed field mappings.
If you do not have any field mappings configured, click the "Add mapping" button to begin setting them up. Add each of your form fields.
Make sure you have Autofill enabled
You can check this here. If Autofill is not enabled, then Clearbit will not enrich the form.
If you want Form Shortening, then make sure it is turned on
You can check this here. If Form Shortening is off, then all form fields will remain visible at all times. Once toggled on, form fields (other than the Email field) will remain hidden, only appearing if Clearbit does not have data available.
Make sure you have jQuery installed on your site
Having jQuery loaded on the page is a prerequisite to getting forms enrichment to work. You may have to check with your own web development team to determine if this is added to your site.
Are you implementing the form on HubSpot CMS or a HubSpot Landing Page?
Our engineers are working to adjust this integration so an alternative script will not be necessary for these implementations - coming soon!