ads

Lead ads field mappings to HubSpot

Last updated: November 19, 2019

When you enable lead syncing for Facebook or LinkedIn, HubSpot will create corresponding versions of your lead ad forms and Lead Gen Forms. These forms won't be visible in your forms tool, but will sync data to your HubSpot properties, and can be used as filters in your lists and workflows.

HubSpot will recreate Facebook lead ad forms automatically when you enable lead syncing for a business page. Hubspot will recreate LinkedIn Lead Gen Forms when HubSpot receives the first synced lead. 

Below you'll find information about how HubSpot automatically maps lead ad form fields to HubSpot properties.

Custom field mappings

Custom fields on Facebook lead ad forms and LinkedIn Lead Gen Forms will automatically be created in HubSpot as single-line text properties in the Lead Ad Properties property group.

The name of these HubSpot properties will be based on the form field’s key (Facebook lead ads) or question (LinkedIn Lead Gen Forms), excluding any non-English characters and substituting spaces with underscores. For example:

Custom field on Facebook lead ad Custom property created in HubSpot
How did you hear about us? how_did_you_hear_about_us
¿Qué productos le interesan? que_productos_le_interesan

Field mapping limitations

  • Form fields that do not contain any English characters will not be synced to HubSpot. Consequently, their responses will not be synced to HubSpot.
  • Hidden form fields will not be created in HubSpot.
  • If an existing HubSpot property has the same internal name as a form field's key or question, new properties will not be created for the field. Instead, the field will be mapped to that existing property.
  • Custom lead ad form fields cannot be synced to default HubSpot properties.

Default Facebook lead ads field mappings

Facebook lead ad field HubSpot property
email email
full_name first name + last name
first_name first name
last_name last name
phone_number phone
street_address address
city city
state state
province province
country country
post_code zip
zip_code zip
company_name company
job_title job title
work_phone_number mobile phone
work_email Maps to email if no email is specified. Otherwise, creates work email property.

Default LinkedIn Lead Gen Form field mappings

LinkedIn Lead Gen Form field HubSpot property
email address email
first_name first name
last_name last name
phone_number phone
city city
state state
country country
zip_code zip
company_name company
company_size company size
industry industry
job_title job title
job_function job function
seniority seniority
degree degree
field_of_study field of study
school school
start_date start date
graduation_date graduation date
date_of_birth date of birth
gender gender
work_phone_number mobile phone
work_email Maps to email if no email is specified. Otherwise, creates work email property.
/ads/lead-ads-field-mappings-to-hubspot