Articles in this section

See more

Facebook Lead Ads + Iterable Integration

You can connect the data from your Facebook lead ads with your user data in Iterable using Zapier, which lets you pass data to Iterable from other apps without any coding.

For this integration method, you'll need:

In this article

Setup instructions

In Iterable

  1. Go to Integrations > API Keys.
  2. Click New API Key.
  3. Give your API key a name (for example, "Facebook Lead Ads Integration") and select Server-side.
  4. Click Create.
  5. Copy the API key to your clipboard — you'll use it a later step.

NOTE

Store this API key in a secure location. After you close the setup menu, Iterable can only display the key’s last 8 characters. If you lose the full API key, you’ll have to create a new one.

In Facebook Lead Ads

  1. Create a Facebook Lead Ads form.
  2. Set up your form, making sure to include an email field, so Iterable can connect form responses with the right user profiles in Iterable.

In Zapier

Create a new Zap.

Add a trigger for your Zap

  1. For the trigger app, select Facebook Lead Ads.

    NOTE

    Facebook Lead Ads is a Zapier premium app.

    Selecting Facebook Lead Ads as the Trigger app

  2. For the trigger event, select New Lead.

  3. Click Test to make sure your Facebook lead ads account is connected (you should see a green Success message if it's working).

  4. For Page, select the Facebook page where your lead ads form will display.

  5. For Form, select the Facebook lead ads form you created earlier.

  6. Submit a test form, or use Facebook's Lead Ads Testing Tool to submit a form with sample information. If everything is working, you should see a green Test Successful! message.

Add an action for your Zap

  1. For the action app, select Iterable.

  2. For the action event, select Create a User.

    Selecting Create a User as the action event

  3. For the app account, enter the Iterable API key you created earlier.

  4. Set up the action by telling Zapier which data to send to Iterable. Iterable's POST /api/users/update API endpoint accepts the following fields:

    • Email: The user's email address. Will populate when you select the Email tag in Facebook Lead Ads.

    • User ID (Optional for email-based projects): The user’s Iterable userId.

    • JSON Data Fields: A JSON object that is passed to the Iterable API with the user's data fields. (Requests containing data fields with data types that conflict with previous requests will be rejected.)

      Example:

      {
   "favoriteColor": "blue" 
}

    • Merge Nested Objects?: Allows you to merge the values in any analogous fields in nested JSON objects instead of replacing those values. To learn more see, Updating User Profiles.

  5. Click Test to make sure your Zap is working (a new user should be added to your Iterable project).

  6. When you're finished setting up your Zap, click Publish and Turn Zap On.

To check that the integration is working, go to Audience > Contact Lookup in your Iterable project and check that your test user was added.

Here's what the data captured by this integration looks like in an Iterable user profile:

{
   "email": "user@example.com",
   "profileUpdatedAt": "2022-04-28 09:44:50 +00:00",
   "signupDate": "2022-04-28 09:44:50 +00:00",
   "signupSource": "API",
   "source": "facebook_lead_ads"
}

Want to learn more?

To learn more about creating Zaps, see Zapier's support doc Create Zaps.

Related articles