Reports

How does HubSpot map to Facebook Lead Ads fields?

Last updated: September 22, 2017

Available For:

Marketing: Free, Starter, Basic, Pro, Enterprise
Sales: Free, Professional
Add-Ons: Ads

Facebook's default fields will be mapped to HubSpot automatically. For custom fields, you can sync your custom Facebook Lead Ads fields to HubSpot by matching the Facebook Field ID to the Internal name of the corresponding property in HubSpot. 

 

 

Default Facebook Lead Ads field mappings

The table below provides a list of default Facebook Lead Ads field mappings in HubSpot:

Facebook Default Field

HubSpot Field

New HubSpot Field Created

email

email

 

full_name

firstname + lastname

 

first_name

firstname

 

last_name

lastname

 

phone_number

phone

 

street_address

address

 

city

city

 

state

state

 

province

state

 

country

country

 

post_code

zip

 

zip_code

zip

 

date_of_birth

X

date_of_birth

gender

X

gender

marital_status

X

marital_status

relationship_status

X

relationship_status

military_status

X

military_status

company_name

company

 

job_title

jobtitle

 

work_phone_number

mobilephone

 

work_email

Maps to email if no email specified. Otherwise create work_email field.

work_email

Most of these properties map to existing default HubSpot properties, while other properties (such as Date of birth) will automatically generate a new HubSpot property and field mapping when the Facebook field syncs with HubSpot. 

Mapping custom Facebook Lead Ads fields to HubSpot

While default fields will map automatically, you can sync your custom Facebook Lead Ads fields to HubSpot following the steps below:

  • Navigate to Contacts Settings:
    • In your HubSpot Marketing BasicProfessional, or Enterprise account, navigate to Contacts Contacts Settings
    • In your HubSpot Marketing Free or Starter account or HubSpot Sales account, navigate to Contacts. Click the Actions dropdown menu and select Edit properties.
  • Create a new property or locate the existing property to which you'd like your Lead Ads field to sync. 
  • Copy the Internal name value for the property.

  • In your Facebook Ads account, change the Field ID for the field in question in your lead ads form by following the steps here. Paste the value you copied from the Internal name field in HubSpot into the Field ID

  • This also works in the other direction. You can copy the field ID of an existing Facebook Lead Ad field and copy that into the internal name of a new HubSpot contact property. This will create a mapping going forward.

Was this article helpful?