Facebook Lead Forms

Running Facebook ads to capture leads? This integration automatically sends those leads into DM Champ 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 DM Champ through an automation platform (such as Pabbly, Zapier, or Make). These platforms act as a bridge between Facebook and DM Champ, passing lead information from one to the other using the DM Champ 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.

• A DM Champ 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 DM Champ 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 DM Champ automatically (using two API calls - automated requests that pass data between systems).

3. DM Champ 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 DM Champ:

• Method: POST

• URL: https://api.dmchamp.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.dmchamp.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 DM Champ 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 DM Champ, 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 DM Champ 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.dmchamp.com/v1/contacts?apiKey=YOUR_API_KEY

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

Create Contact - Response

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

Add Contact to List - Request

POST https://api.dmchamp.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, DM Champ 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 DM Champ list 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.