# Facebook Leads

Connect Facebook Leads as a data source: authorize with your Meta account, choose the page and lead form to import, how its fields map to Instasent attributes, and how lead consent is handled.

**Language:** en
**Audience:** platform
**TLDR:** Facebook Leads is a native OAuth connector: you authorize Instasent with your Meta account (read-only access), then pick the Facebook page and lead-ad form to import from. Each data source imports from a single form and brings leads in as contacts on a one-way periodic sync.
**Translation key:** platform.data-sources.connectors.facebook-leads
**Search keywords:** Facebook Leads, Meta, Facebook, lead ads, lead form, Facebook page, leads, OAuth, connect Facebook Leads, Facebook Leads integration, lead generation
**Related pages:** /platform/es/data-sources/connectors/facebook-leads, /platform/en/data-sources/connectors, /platform/en/data-sources/connectors/intercom, /platform/en/data-sources/managing, /platform/en/consent
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/en/llms.txt
**This page:** https://docs.instasent.com/platform/en/data-sources/connectors/facebook-leads/ (HTML) · https://docs.instasent.com/platform/en/data-sources/connectors/facebook-leads.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/data-sources/connectors/facebook-leads.md

Facebook Leads is the native connector for the leads your lead-ad forms collect on
Facebook. Once authorized, it brings those leads into Instasent as contacts, so anyone
who submits one of your forms lands in your audience without any manual export.

## How to connect

Facebook Leads is a **[native OAuth connector](/platform/en/data-sources/connectors#native-oauth)**:
you authorize Instasent with your **Meta account** and, once connected, pick which page
and lead form to import from. There's no key to create or copy anywhere.

#### 1. Add the data source

In **Data sources**, select **Add data source** and choose **Facebook Leads** from
the Integrations section.

#### 2. Continue with Facebook

Select **Continue with Facebook** to open Meta's authorization window. You can
choose which businesses and pages Instasent may access. Instasent will only **read
your forms and retrieve your leads** — read-only access.

#### 3. Choose the page and form

Back in Instasent, select the **Facebook page** and then the **Facebook Leads form**
to import from. Each data source imports from one form.

#### 4. Initial import

The connector imports the existing leads from that form, then keeps checking for new
ones on a periodic sync.

![The Connect Facebook Leads setup page with the connector description, the data it syncs and the contact fields it maps](/platform/en/data-sources/images/facebook-leads--1-connect.png)
*The Facebook Leads connector page: what it brings into Instasent and the contact fields it maps, with Connect Facebook Leads to start.*

## What it syncs

- **Contacts** — the leads submitted through the selected lead form, with the fields the
  form captured (name, email, phone).

The sync is one-way, **from Facebook into Instasent**, and runs periodically to pick up
new leads. Instasent only reads your forms and their leads; it never edits anything on
Facebook. Contacts unify with the rest of your audience by email and phone, the same as
any source — see [unification](/platform/en/data-sources/managing#how-unification-works).

## Field mapping

The lead form's fields map to the matching Instasent attributes — email to `_email`,
phone to `_phone_mobile`, name fields to their attributes. As with any source you
confirm the mapping on setup; see
[field mapping](/platform/en/data-sources/managing#field-mapping).

## Consent mapping

{/* VERIFY: the exact Facebook Leads → Instasent consent mapping is not yet confirmed. The mapping below applies the consent golden rule; confirm against the connector's actual behaviour before treating it as definitive. */}

Map any marketing consent the lead form captured to Instasent's marketing-preference
attribute (`_accepts_marketing_*`) following the consent golden rule:

| Lead status          | Instasent value | Meaning                               |
| -------------------- | --------------- | ------------------------------------- |
| Opted in on the form | `true`          | Accepted marketing                    |
| No consent captured  | `null`          | No preference — never opted in or out |
| Opted out            | `false`         | Actively declined marketing           |

Only an **active opt-out** becomes `false`. A lead with no recorded consent maps to **no
preference** (`null`), never to `false`. For what these values mean for who receives a
campaign, see [Consent](/platform/en/consent/marketing-preference-vs-suppression).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.