> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta lead form tracking

> Set up Meta lead form tracking in Cometly so every Facebook and Instagram instant form lead is recorded and tied to the ad that generated it.

Meta lead form tracking brings the leads from your Meta instant forms (the lead forms people fill in on Facebook and Instagram without leaving the app) into Cometly automatically. Every lead is recorded as a **Lead** event, which is Cometly's record of an action a person takes on the way to becoming a customer. In **Events Manager**, the **Integration** column shows these as **Meta Instant Form**.

Cometly attributes each lead to the ad that generated it. That lets you see which campaigns, ad sets and ads actually produce your leads, so you can decide where to spend.

> [!WARNING]
>
> The Meta profile that connected the ad account to your Cometly space (the workspace that holds your settings, integrations and data) must:
>
> 1. Have full access to manage the page.
> 2. Be assigned to the page in the **Leads Access** section of Meta Business settings.

> [!NOTE]
>
> **Agencies:** if you work with Business Partner access, see [Lead form tracking for agency clients](#lead-form-tracking-for-agency-clients) to make sure you are set up correctly.

## Connect Meta and choose your pages

**1. Connect your Meta profile to Cometly**

In Cometly, go to [**Integrations**](https://app.cometly.com/integrations), open **Meta Ads** under **Ad Platforms** and click **Sign in with Facebook**. Log in to Facebook if you are asked to.

**2. Select your business**

In the Facebook dialog, select the business (Business Manager) that owns the page running your lead forms. Check that it is the right one before you continue.

**3. Choose the pages to track**

Select the page or pages whose lead forms you want to track, then confirm.

**4. Connect the ad account to your space**

Back in Cometly, click **Connect & Sync Data** on the ad account that runs your lead form ads, if it is not connected yet. Cometly matches each lead to an ad in a connected ad account.

## Add a new page or resync your Meta profile

If your Meta profile is already connected but you need to add a new page, or leads are not showing up in Cometly:

1. Go to **Integrations** and open **Meta Ads** under **Ad Platforms**.

2. Click **Resync**. In the Facebook dialog, click **Edit previous settings** if you want to add a business or a page.

   ![Facebook dialog asking to reconnect to Cometly, with an arrow on the Edit previous settings link](https://mintcdn.com/cometly/4NU5YV9iL1PADmGE/images/integrations/forms/meta-lead-forms/01.webp?fit=max\&auto=format\&n=4NU5YV9iL1PADmGE\&q=85\&s=1839d048366706488f6dc610f49cf908)

3. Select the business and the pages you want to track lead forms for again.

## Check Leads Access in Meta Business settings

Both Cometly and the connected Meta profile need Leads Access to your page.

1. In Meta Business settings, click **Integrations > Leads Access**.

   ![Meta Business settings with Integrations expanded and an arrow on Leads Access](https://mintcdn.com/cometly/4NU5YV9iL1PADmGE/images/integrations/forms/meta-lead-forms/02.webp?fit=max\&auto=format\&n=4NU5YV9iL1PADmGE\&q=85\&s=3db3ba1340494642efab086201c3a5cc)

2. Click **CRMs**. If Cometly is not listed for your page, click **Assign CRMs** and assign Cometly.

   ![Meta Leads Access CRMs tab listing Cometly as a connected CRM, with the Assign CRMs button](https://mintcdn.com/cometly/4NU5YV9iL1PADmGE/images/integrations/forms/meta-lead-forms/03.webp?fit=max\&auto=format\&n=4NU5YV9iL1PADmGE\&q=85\&s=554aab62d1fea55e8ea8237e65115861)

3. Click **People** and check that you are listed. If you are not, click **Assign people** and give yourself access. You must be an admin of the page to do this.

   ![Meta Leads Access People tab with the Assign people button and the people who have lead access](https://mintcdn.com/cometly/4NU5YV9iL1PADmGE/images/integrations/forms/meta-lead-forms/04.webp?fit=max\&auto=format\&n=4NU5YV9iL1PADmGE\&q=85\&s=8e1c21bb29575cc79c4690b8983c7ce1)

## Form settings

When you create your instant form, use Meta's standard **Field names**, found on the form's **Settings** tab. Meta uses these names by default:

| Field | Field name |
| - | - |
| Email | `email` |
| Full name | `full_name` |
| First name | `first_name` |
| Last name | `last_name` |
| Phone number | `phone_number` |

Cometly also reads Meta's work email (`work_email`) and work phone number (`work_phone_number`) fields.

> [!NOTE]
>
> If an existing form uses custom field names, change them back to the default names above. Otherwise Cometly will not capture that data.

![Meta Create form dialog on the Settings tab showing the default field names email, full\_name and phone\_number](https://mintcdn.com/cometly/4NU5YV9iL1PADmGE/images/integrations/forms/meta-lead-forms/05.webp?fit=max\&auto=format\&n=4NU5YV9iL1PADmGE\&q=85\&s=95e0ac637801b6daabd37b9f10e6441c)

## Lead form tracking for agency clients

If you are an agency managing Meta lead form tracking for a client, **Business Partner access is not enough** to add Cometly as a CRM in Meta. Use one of these two options.

### Option 1: Get invited to the client's Business Manager

* Ask the client to invite your personal Meta profile to their **Business Manager** as an **Admin** (not just a Partner).
* Once you are an admin, you can assign Cometly as a CRM and set up Leads Access.

### Option 2: Have the client connect Facebook to Cometly

* Invite the client to your **Cometly space** as an **Advertiser**.
* Have the client connect their **Meta ad account** in Cometly with their own Facebook login.
* They can then assign Cometly as a CRM from their own Business Manager.

> [!TIP]
>
> If Cometly is not listed under CRMs for a page, the connection was not completed with the right level of access. Check that the ad account was connected in Cometly by the right profile and that Leads Access has been assigned.

## Check it worked

When the next lead comes in from one of your lead form ads, open **Events Manager**. The lead appears as a **Lead** event with **Meta Instant Form** in the **Integration** column. If no leads show up, resync your Meta profile and check Leads Access, as described above.

## Frequently asked questions

### Do I need the Cometly pixel on my website to track Meta lead forms?

No. Meta sends the lead to Cometly when someone submits the form, and Cometly matches it to the ad it came from, so no website visit is involved. You still need the pixel to track visitors and forms on your own site.

### Does Cometly send Meta lead form leads back to Meta through the Conversion API?

No. Meta already has these leads, because the form was filled in on Facebook or Instagram. Cometly records the **Lead** event without sending it back through the Conversion API (the server-side connection that sends your conversions to ad platforms).

### Why is my Meta test lead not showing in Cometly?

Cometly records a lead only when Meta says which ad it came from and that ad belongs to an ad account connected to your space. A lead that arrives without an ad, which is usually the case for test leads, is skipped. To check your setup, wait for a lead from a live lead form ad.

## Next steps

* [See whether lead forms pass the Tracking Health check](https://docs.cometly.com/getting-started/tracking-health.md)
* [Learn how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)
* [Connect or manage your Meta ad account](https://docs.cometly.com/integrations/ad-platforms/meta.md)
* [Send conversions to Meta with the Conversion API](https://docs.cometly.com/guides/conversion-api/meta.md)
* [Track LinkedIn Lead Gen Forms](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.