Engagement Audiences for Lead Ads

Automatically create audiences for people who engaged with Lead Ads, this is known as an engagement audience.

Creating an Engagement Audience

You create an engagement audience by creating a Custom Audience with subtype set to ENGAGEMENT.

You should set object_id to <FORM_ID> and set the rule to track one of the following Lead Ads events:

Event Description


All users who completed the form and submitted it.


All people who close the form without submitting it. They may or may not have filled in any of the fields.


All people who opened the Lead Gen form regardless of whether or not they submitted the form.

The access token you provide to create an engagement audience must have at least an advertiser role on the Page that publishes the Lead Ads form.

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;

$audience = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
  CustomAudienceFields::NAME => 'Lead Ads Engagement Audience',
  CustomAudienceFields::SUBTYPE => 'ENGAGEMENT',
  CustomAUdienceFields::DESCRIPTION => 'Users who submitted lead ad form',
  CustomAUdienceFields::RULE => array(
      'object_id' => <FORM_ID>,
      'event_name' => 'lead_generation_submitted',

from facebookads.adobjects.customaudience import CustomAudience

audience = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
audience[CustomAudience.Field.subtype] = CustomAudience.Subtype.engagement
audience[CustomAudience.Field.name] = 'Lead Ads Engagement Audience'
audience[CustomAudience.Field.description] = 'Users who submitted lead ad form'
audience[CustomAudience.Field.rule] = [
        "object_id": <LEADGEN_FORM_ID>,
        "event_name": "lead_generation_submitted",
curl \
  -F 'name=Lead Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who submitted lead ad form' \
  -F 'rule=[{"object_id":"<FORM_ID>","event_name":"lead_generation_submitted"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \

For more information about custom audiences, see Custom Audience, Reference.