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

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# Meta Lead Ads

> Connect your Meta Business account so lead forms on your Facebook and Instagram Pages send candidates to Journeyfront.

> [!NOTE]
>
> **Who can do this:** Admins with *Company Settings Access* connect Meta. The person who connects must also be a Page admin and a Business admin in Meta. Recruiters don't need any Meta access.
>
> **Availability:** Meta Lead Ads needs to be turned on for your account. Ask your Customer Success Manager.

This page covers connecting Meta to Journeyfront. Once your Meta Business account is connected, the lead forms on the Pages you choose come into Journeyfront, ready to link to job reqs. Linking forms, mapping their questions and following each lead are the same for every platform; see [Lead ads](https://help.journeyfront.com/sourcing/lead-ads.md).

## Before you start

* **Your lead forms live in Meta.** Create them in Meta Ads Manager. Journeyfront brings in the forms from the Pages you connect, but can't create forms for you.
* **The right Meta access.** The person connecting needs to be both a Page admin and a Business admin on your Meta Business account.
* **Company Settings access** in Journeyfront.
* **Leads Access, if your business uses it.** If your Meta Business restricts who can access leads, a Business admin also needs to allow Journeyfront as a CRM. See [Allow Journeyfront in Leads Access](#allow-journeyfront-in-leads-access).

## Step 1: Connect your Meta Business account

**1. Open the Meta Business tile**

Go to **Settings**, then **Integrations**, and click the **Meta Business** tile.

**2. Connect**

Click **Connect Meta Business**. A Facebook window opens.

**3. Choose your Business and Pages**

Log in, choose the Meta Business whose lead forms you want, and choose one or more Pages.

**4. Approve the permissions**

Approve all six permissions Journeyfront asks for. Leave every one turned on; if one is missing, Journeyfront asks you to reconnect.

| Permission | What it lets Journeyfront do |
| - | - |
| `leads_retrieval` | Read the answers people submit on your lead forms. |
| `pages_show_list` | List the Pages you manage so you can choose which to connect. |
| `business_management` | See your Meta Business and the Pages it owns. |
| `pages_manage_ads` | Read your lead forms and their questions, and create test leads. |
| `pages_manage_metadata` | Ask Meta to send each new lead to Journeyfront as soon as it's submitted. Without it, no leads arrive. |
| `pages_read_engagement` | Read Page content that Meta requires for reading lead forms. |

Journeyfront can't post to your Page, change your ads, or read your Page's messages.

When the window closes, the Meta Business page shows an **Active** badge, the **Connection Details** (the Meta Business, who connected it and when, and the permissions granted) and the Pages you connected under **Connected Sources**.

### Allow Journeyfront in Leads Access

Meta's **Leads Access** setting controls which people and CRMs can receive leads for a Page. If your business uses it, Meta only sends leads to the CRMs on the list. Until Journeyfront is added, the connection looks healthy, but new leads never reach Journeyfront.

You need this step if any of these are true:

* Your Meta Business has set up Leads Access for the Page, or you're not sure whether it has.
* The form's health check shows leads at Meta marked **Never received**, even though **Page sends lead notifications** is **OK**.
* The Page shows **Receiving leads**, but the form's **Leads** count stays at 0.

A Business admin for the Meta Business that owns the Page can do this in about a minute:

**1. Open Business Settings**

Go to [business.facebook.com/settings](https://business.facebook.com/settings).

**2. Open Leads Access**

In the left menu, open **Integrations**, then **Leads Access**.

![Meta Business Settings with Integrations open in the left menu and Leads Access selected, next to the list of Pages](https://mintcdn.com/journeyfront/TsRdZPokbqACysWJ/images/integrations/meta-lead-ads/meta-leads-access-menu.png?fit=max\&auto=format\&n=TsRdZPokbqACysWJ\&q=85\&s=818dc17bc856010260a83fdf6d3d89ee)

**3. Select your Page**

Select the Page your lead forms are on.

**4. Assign Journeyfront**

Open the **CRMs** tab and click **Assign CRM**. In **Add CRMs and set permissions**, paste the Journeyfront app ID into **Search**: `1661431234740842`. Searching by name doesn't find it. Select **Journeyfront** and click **Confirm**.

![The Add CRMs and set permissions window in Meta Business Settings, with the Journeyfront app ID pasted into Search and the Confirm button](https://mintcdn.com/journeyfront/TsRdZPokbqACysWJ/images/integrations/meta-lead-ads/meta-assign-crm-app-id.png?fit=max\&auto=format\&n=TsRdZPokbqACysWJ\&q=85\&s=ebe790acc972d34d6ff4eeeb985582f7)

> [!NOTE]
>
> Journeyfront only shows up here after the Page is connected in Journeyfront. If the app ID finds nothing, connect the Page first.

When it's done, Journeyfront is listed under **CRMs with leads access**.

![Meta Business Settings with the Acme Careers Page's Leads access panel open on the CRMs tab, and Journeyfront listed under CRMs with leads access](https://mintcdn.com/journeyfront/TsRdZPokbqACysWJ/images/integrations/meta-lead-ads/meta-leads-access-crms.png?fit=max\&auto=format\&n=TsRdZPokbqACysWJ\&q=85\&s=c75750c85f8f404423e77cdc66796297)

New leads start arriving within a few minutes. To bring in the leads that arrived before the change, open the form, run the health check on the **Health** tab, and click **Import missing leads**. See [Check a form's health](https://help.journeyfront.com/sourcing/lead-ads.md#check-a-forms-health).

> [!NOTE]
>
> If Journeyfront is already on the list, or you don't see a **CRMs** tab, Leads Access isn't the cause. Contact your Customer Success Manager.

## Fix connection problems

Each Page under **Connected Sources** on the Meta Business page shows whether Meta is sending its leads to Journeyfront: **Receiving leads**, **Not subscribed** or **Not checked yet**. Hover over the status for details.

| What you see | What to do |
| - | - |
| **Missing permissions** on the Meta Business page | Click **Reconnect** and approve every permission in the Facebook window. |
| **Not subscribed** next to a Page | Leads from that Page aren't reaching Journeyfront. Click **Repair** next to the Page, or choose **Repair Page subscription** from a form's menu on the **Meta Lead Ads** page. |
| A Page you need isn't listed | Click **Reconnect** and pick the Page again. |
| The health check shows leads marked **Never received**, but **Page sends lead notifications** is **OK** | Your Meta Business may be blocking Journeyfront in Leads Access. [Allow Journeyfront in Leads Access](#allow-journeyfront-in-leads-access), then click **Import missing leads**. |

For problems with a single form, such as **Needs mapping** or leads from a form that isn't linked, see [Fix common problems](https://help.journeyfront.com/sourcing/lead-ads.md#fix-common-problems).

## Add Pages or disconnect

* **To add more Pages later**, click **Reconnect** on the Meta Business page and pick the Pages again.
* **To disconnect**, click **Disconnect**. Candidates already in Journeyfront stay; new leads stop coming in.

## FAQ

> [accordion] Is candidate data secure?
>
> Yes. Journeyfront connects through Meta's official sign-up flow, stores the connection securely, and only asks for the permissions needed to receive leads. You can disconnect at any time from the Meta Business page.

> [accordion] Do recruiters need access to our Meta Business?
>
> No. Only the person who connects needs to be a Page admin and a Business admin in Meta. Everyone else works with lead ad candidates in Journeyfront.

> [accordion] Does connecting Meta cover Instagram?
>
> Yes. Instagram lead forms run on the same Meta lead ads system, so forms on your connected Pages come in the same way, whether the lead was submitted on Facebook, Instagram, Messenger or the Audience Network.

## Step 2: Link your lead forms

With Meta connected, your lead forms appear under **Settings**, then **Meta Lead Ads**. Link each one to a job req and map its questions so every submission becomes a candidate.

> [card] [Lead ads](https://help.journeyfront.com/sourcing/lead-ads.md)
>
> Link lead forms to job reqs, map their questions and follow every lead.


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