Facebook Lead Ads

This destination is currently under final review and will be available soon.

Facebook is an online social media and social networking service owned by Meta. Using Conversions API, this destination allows you to get improved performance in your lead ads by sharing your CRM data about your leads back to Meta to unlock quality lead optimization.

Key features

The Facebook Lead Ads destination provides the following key features:

  • Events structure: our Events reference leverages Facebook events, meaning that your data is properly bridged to the expected fields in an optimized way.

  • Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

  • Smart mapping: data mapping can be readjusted using your datalayer defined fields.

Destination setup

Integrating your CRM is required and documented following the Plan Your Project Timeline section via Meta documentation: see 1: Connecting Your CRM With Lead Ads and 2: Getting Started With the CRM Integration for detailed information. This destination covers 3: Implementing the CRM Integration section in the project. Before continuing, you may want to inspect Check If Your Business Is a Good Fit section to see if the optimization model can be beneficial to you. Moreover, you need to review Before you begin and Limitations sections for a checklist of what is needed and current constraints.



Pixel Id

Required Your pixel identifier associated with your Conversions API event(s). You can retrieve your pixel identifier by accessing the Events Manager.

Access Token

Required You can generate an access token by entering the Events Manager, selecting your pixel, and clicking the "Settings" tab. In the "Conversions API" section, you can click the button "Generate access token".

Lead Id

Required The 15 or 16 digit Facebook generated lead identifier from your downloaded leads. More details are available by following this LINK.

Lead Event Source

Required Set this to the name of the CRM/tool where the leads are coming from (E.g. "Hubspot", "SAP", "Oracle", "Dynamics", "In-house CRM", etc...).


Required Your mapping between Facebook's events and yours. In Facebook event name , you can set either a standard event or a custom event name. At least one entry is required. More details are available by following this LINK.

Quick reference

Commanders Act EventsFacebook Events

[Any Event] [1]

[Any Event] [1]

[1] See Mapping for more details.

Field Mappings

Most properties can be remapped using our "Smart Mapping" feature. Facebook properties are set starting from the path data.0 .

Commanders Act PropertiesFacebook Properties

Facebook event name

event_name [*][1]


event_time [*][2]

Lead Id

user_data.lead_id [*]

Lead Event Source

custom_data.lead_event_source [*]

[*] Mandatory property. [1] See Mapping for more details. [2] If this field is not provided, the current timestamp is used.

Last updated