Your AI Connector Docs

Facebook Lead Forms

Running Facebook ads to capture leads? This integration automatically sends those leads into the platform so you can follow up with them via WhatsApp, SMS, or any other connected channel - without lifting a finger.

It works by connecting Facebook Lead Ads to the platform through an automation platform (such as Pabbly, Zapier, or Make). These platforms act as a bridge between Facebook and the platform, passing lead information from one to the other using the API (a way for different software to exchange data automatically).


Prerequisites

Before you start, make sure you have:

  • Facebook Ads Manager access with permission to create Lead Ads.
  • An account with an active API key (generate one in Settings > Account - see API Access for details).
  • An automation platform account - Pabbly Connect, Zapier, or Make (Integromat). These are no-code tools that connect different apps together. This guide uses Pabbly as the example, but the steps are similar on any platform.
  • A contact list in the app where new leads will be added.

Overview

The integration works in three stages:

  1. A prospect fills out your Facebook Lead Form.
  2. Your automation platform detects the new lead and sends the information to the platform automatically (using two API calls - automated requests that pass data between systems).
  3. The platform creates the contact and adds them to the list you specify.

From there, your campaigns handle the rest - whether that is an AI-powered welcome message, a drip sequence, or a manual follow-up.


Step 1: Create Your Facebook Lead Form

  1. Open Facebook Ads Manager.
  2. Create a new campaign with the Leads objective.
  3. At the ad level, choose Instant Form as the lead method.
  4. Build your form with the fields you need. At minimum, include:
    • First name
    • Phone number (with country code)
    • Optional: Last name, email
  5. Publish the ad or save the form as a draft for testing.

Step 2: Test the Lead Form

Before connecting the automation, submit a test lead:

  1. In Ads Manager, go to your Lead Form.
  2. Click Preview and fill out the form with test data.
  3. Confirm the test lead appears in your Facebook Lead Center (under Publishing Tools on your Facebook Page, or in Ads Manager under “Leads”).

This test entry will be used to set up the field mapping in your automation platform.


Step 3: Set Up the Automation

Connect Facebook Lead Ads as the Trigger

  1. Log in to your automation platform (Pabbly, Zapier, or Make).
  2. Create a new workflow / scenario / zap.
  3. Set the trigger to “Facebook Lead Ads - New Lead.”
  4. Connect your Facebook account and select the Page and Lead Form.
  5. Fetch the test lead to confirm the connection works and to map fields.

Configure API Call 1: Create Contact

Add an action step with an HTTP / Webhook / API Request. This tells your automation platform to send the lead’s information to the platform:

  • Method: POST
  • URL: https://api.example.com/v1/contacts?apiKey=YOUR_API_KEY
  • Headers:
    Content-Type: application/json
    
  • Body (JSON):
    {
      "firstName": "{{first_name}}",
      "lastName": "{{last_name}}",
      "phone": "{{phone_number}}",
      "email": "{{email}}"
    }
    

Replace the {{placeholders}} with the actual field mappings from your trigger step.

Important: The phone number must include the country code (for example, +1 for the US or +31 for the Netherlands). If your lead form collects the phone number without a country code, add a formatting step in your automation to prepend it.

The API response will return a contact object that includes the new contact’s ID. Save this value - you need it for the next step.

Configure API Call 2: Add Contact to List

Add a second action step:

  • Method: POST
  • URL: https://api.example.com/v1/lists/YOUR_LIST_ID/contacts?apiKey=YOUR_API_KEY
  • Headers:
    Content-Type: application/json
    
  • Body (JSON):
    {
      "contactId": "{{contact_id_from_previous_step}}"
    }
    

Replace YOUR_LIST_ID with the actual ID of your contact list (see below for how to find it), and map contactId to the ID returned by the first API call.


Finding Your List ID

  1. In the app, go to Contacts > Lists.
  2. Open the list you want to use.
  3. The List ID is shown in the list details panel, or you can copy it from the URL in your browser’s address bar.

Step 4: Test the Full Workflow

  1. Submit another test lead through your Facebook form (or replay the existing test lead in your automation platform).
  2. Check the platform to confirm:
    • The contact was created with the correct name, phone number, and email.
    • The contact was added to the correct list.
  3. If you have a campaign assigned to that list, confirm that the campaign triggers as expected (for example, a welcome message is sent).

Data Reference

Below are examples of the data sent and received during the integration. If you or your developer need to troubleshoot, these show exactly what the requests and responses look like.

Create Contact - Request

POST https://api.example.com/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "[email protected]"
}

Create Contact - Response

{
  "id": "abc123xyz",
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "[email protected]",
  "createdAt": "2026-01-15T10:30:00Z"
}

Add Contact to List - Request

POST https://api.example.com/v1/lists/LIST_ID/contacts?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz"
}

Tips

  • Duplicate handling: If a contact with the same phone number already exists, the platform will return the existing contact instead of creating a duplicate. The add-to-list step still works as expected.
  • Multiple forms: You can create separate automation workflows for different lead forms, each targeting a different list in the app and campaign.
  • Error notifications: Configure your automation platform to notify you if an API call fails, so you do not lose leads.

Next Steps

  • Creating Campaigns - Set up a campaign to automatically message new leads.
  • API Access - Full API documentation for advanced integrations.
  • Webhooks - Get notified when contacts are created or tagged.