Legacy: Set Up Clearbit Enrichment for Marketo Forms

Last Updated: November 8, 2022

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

❗Disclaimer: If you signed up after Feb 15, 2022, please follow these instructions on Set Up Clearbit Forms for Marketo.

This article shows you how to set up Clearbit Enrichment for Marketo Forms with Clearbit's Legacy Integration. You'll first need to Update your Allowed Referrers in Clearbit, to make sure that no one but you is using your Clearbit account to enrich forms.

1. Go to the API settings of your main Clearbit dashboard.
2. Scroll down to the Allowed Referrers portion of the API Settings section.
3. Add the domain(s) your form is going to appear on. For example, if your form is going to display on a landing page at https://example.com/my-landing-page, you would add "example.com". To make sure the form works on all subdomains, like any testing sites, you can also add the domain "*.example.com".
4. Click the Save Changes button.
   
5. To power Clearbit's form shortening feature, you'll need to create a custom field that will be used to check whether Clearbit returned data about a lead or not. First, log in to your Marketo account and go to the Admin section in the navigation bar.
6. Select Field Management from the left panel, under the Database Management group.
7. Click on New Custom Field from the main panel and create a field with the following properties:
   
   • Object: Person
   • Type: String
   • Name: Clearbit Form Status
   • API Name: clearbitFormStatus
8. Click Create.
   
   📝 Please note: the API Name of the field must be exactly clearbitFormStatus in order for it to work correctly.
   
9. Now, we'll create your form. Go to the Design Studio section of the navigation bar.
10. Click New and select New Form from the available options below.
11. Fill in the modal with the appropriate information.
    
    
12. When creating your form, make sure to move up Email Address as the first field. That's the only required visible field and the one Clearbit will use to look for data on that lead.
    
    
13. Let's now add the custom field we created earlier (Clearbit Form Status) and set its field type as hidden so that users won't see it.
    
    
14. Now, we'll add dynamic fields for form shortening. The last part of editing your form involved adding as many of the mapped data points you configured previously in the Setting up Clearbit Enrichment for Marketo set up guide. You can view them by going straight to the Data Mappings section of your Clearbit for Marketo dashboard. In order to make these fields dynamic, we have to enable Visibility Rules on them.
    
    Let's create an example form with these fields: First Name, Last Name, Job Title, Website. We'll be using First Name to show the pattern we'll follow for the rest of the fields. Click the First Name field.
15. Look at the properties table to the right and scroll down until you find Visibility Rules. Click on Disabled to open up the rules modal.
16. Select Hide as the behavior we want to start with. The fields will remain hidden when any of the conditions we set are met.
17. The first condition should check if Clearbit Form Status is empty. Since no email has been inputted when the user first arrives on the form, Clearbit hasn't searched for data on that person, so the field should remain hidden.
18. The second condition checks if Clearbit Form Status contains data on the property FirstName. If Clearbit returned data on that field, we want it to stay hidden. If not, we want it to be visible so the user can type it in.
    
    📝 Please Note: Clearbit writes data to the ‘SOAP API Name’ of the field, not the ‘Friendly Label’. You can download the list of standard fields here. Or you can view both standard and custom fields by jumping to Admin > Database Management > Field Management and clicking on Export Field Names.
    
    
19. When you're done with your form, click Finish in the top right corner and then click the Approve and Close buttons right after that.
20. To add your form to your website, go back to the Design Studio section of your navigation bar and select the form you just created.
21. Select Form Actions and click on Embed Code from the available options below.
22. Copy the embed code and paste it wherever you'll be using it in your website.
23. Now, add the Clearbit Javascript snippet to your website. Go to the Forms section of your Clearbit for Marketo dashboard.
24. Click the Copy Code button to copy the snippet to your clipboard.
    
    
25. Paste it above the closing </head> tag of all the individual pages where you'll be using forms containing Clearbit enrichment.