Facebook Lead Ads via Zapier integration

With the Facebook Lead Ads integration via Zapier, you can import your leads from Facebook into Braze and track a custom event when leads are captured.

Facebook Lead Ads is an ad format that allows businesses to collect lead information directly in Facebook. These ads are designed to make the lead generation process easy and seamless. By leveraging a Zapier integration and Braze, you can automate the transfer of lead data from Facebook to Braze, enabling real-time engagement and personalized follow-up actions.

Prerequisites

Integration

Step 1: Create a Lead Ads campaign with an instant form

From Facebook Ads Manager, create a Facebook Leads campaign and Facebook Lead Ads form.

You can use either an email address or phone number when making a request to the /users/track endpoint to update or create the user profile. For this reason, include a Contact field for email or phone in your lead ad form. If you’re collecting first names or last names, collect those separately in your form instead of using full names.

Step 2: Connect your Facebook account to Zapier

Step 2a: Select your connection method in Zapier

In Zapier, go to Apps to search for available Facebook apps. Select either Facebook Lead Ads or Facebook Lead Ads (for Business admins).

For more information on these two methods of connecting your Facebook account to Zapier, refer to:

• Facebook Lead Ads (for Business Admins)
• Facebook Lead Ads

Step 2b: Add Zapier to Leads Access in Facebook Business Manager

In your Facebook Business Manager, go to Integrations > Leads Access on the left-hand menu. Select your Facebook Page, then click CRMs. On the CRM tab, select Assign CRMs and add Zapier.

For steps to assign Zapier as a CRM integration, refer to Facebook’s documentation.

Step 3: Create your Zap

Step 3a: Create the trigger

Once you have connected your Facebook account, you can proceed to create a Zap. For the Trigger, select Facebook Lead Ads or Facebook Lead Ads (for Business Admins) based on your choice from step 2.

For the Event, select New Leads > Continue.

Select your Facebook account, then Continue.

Select your Facebook Page and instant form you previously created, then Continue.

Next, test this trigger. After validating your form output, select Continue with selected record.

Step 3b: Create an action

Add a new step, then select Webhooks by Zapier. Next, select Custom Request for the Event field, then click Continue.

Lastly, set up your custom request by inserting fields in your payload. The following code snippet shows an example payload.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
    "attributes": [
        {
            "email": "<insert_email_field>",
            "first_name": "<insert_first_name_field>",
            "last_name": "<insert_last_name_field>",
            "lead_form": "<insert_form_name_field>",
            "fb_campaign": "<insert_campaign_id_field>",
            "fb_ad_set": "<insert_campaign_id_field>",
            "fb_ad": "<insert_campaign_id_field>",
            "email_subscribe": "subscribed",
            "subscription_groups" : [{
                "subscription_group_id": "<subscription_group_id>",
                "subscription_state": "subscribed"
                }
            ]
        }
    ],
    "events": [
        {
            "email": "<insert_email_field>",
            "name": "<insert_custom_event_name>",
            "time": "<insert_timestamp_field>",
            "_update_existing_only": false
        }
    ]
}`

Here’s an example of what this looks like in Zapier:

After configuring your webhook, select Continue and test. If the test is successful, you can publish your Zap.

Step 4: Test your Facebook Lead Ads Zap

To test this end-to-end, use Facebook’s Leads Ads Testing Tool in your Facebook Developer Console. For more information, see Testing and Troubleshooting.

User identity management

This integration allows you to attribute your Facebook leads by email through the /users/track endpoint.

• If the email matches an existing user profile, Braze will update the profile with Facebook leads data.
• If there are multiple user profiles with the same email, Braze will prioritize the most recently updated profile with an external ID for updates.
• If the external ID doesn’t exist, Braze will prioritize the most recently updated profile with the matching email.
• If no profile exists with the provided email, Braze will create a new profile and a new alias user profile will be created. To identify the newly created alias user profiles, use the /users/identify endpoint.

Troubleshooting