> ## 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.

# Lead ads

> Turn lead ad form submissions into candidates on your job reqs automatically, with their answers, source and the ad they came from.

> [!NOTE]
>
> **Who can do this:** Admins with *Company Settings Access* link and manage lead forms, under **Settings**, then **Meta Lead Ads**, or from a job req's **Setup** tab (which also needs *Manage Job Req Settings*). Recruiters work with lead ad candidates like any other applicant.
>
> **Availability:** Lead ads need to be turned on for your account. Ask your Customer Success Manager.

A lead ad shows a short form right inside a social app, already filled in with the person's name and contact details. Candidates tap, check their details, answer a question or two and submit without leaving the app, which is why lead ads tend to bring in many more applicants than ads that send people to a website.

Journeyfront brings those submissions straight in, usually within seconds. Each lead becomes a Candidate Application on the job req you choose, keeps the campaign and ad it came from, and can get a one-tap email to finish applying with their answers already filled in.

No more exporting spreadsheets from an ads manager, and fewer leads going cold before anyone contacts them. Because every candidate keeps their campaign and ad, you can see which ads lead to hires, not just clicks.

[Meta Lead Ads](https://www.youtube.com/embed/BgILz2H277w)

## Supported platforms

Journeyfront brings in lead ads from **Meta**: lead forms on your Facebook Pages, whether the lead was submitted on Facebook, Instagram, Messenger or the Audience Network. An admin connects your Meta Business account once, and your forms then appear under **Settings**, then **Meta Lead Ads**.

> [card] [Connect Meta Lead Ads](https://help.journeyfront.com/integrations/meta-lead-ads.md)
>
> Connect your Meta Business account and choose the Pages whose lead forms come into Journeyfront.

## How it works

1. **You build the lead form and ad** in the platform's ads manager, as you normally would.
2. **You link the form to a job req** in Journeyfront and map its questions to your fields and screening questions.
3. **Someone submits the form.** Journeyfront creates a Candidate Application on the linked job req. It starts at the beginning of the job req's workflow, like any other applicant.
4. **The candidate gets one invitation email**, if you turned it on, to finish the full application.

Every lead is logged, so you can see what came in, what didn't and why, and bring in leads that failed once you've fixed the cause.

## Link a lead form to a job req

Go to **Settings**, then **Meta Lead Ads**. Your lead forms appear automatically. Journeyfront checks for new forms every day; click **Refresh from Meta** to check now.

**1. Open the form's menu**

Find the form and open its actions menu, then choose **Connect to job req**.

**2. Pick the job req**

In **Job req**, choose where new candidates should go. A form links to one job req at a time.

**3. Check the source**

By default, the source is set from where each lead was submitted. To use one of your own sources instead, click **Add source override**. See [Sources for lead ad candidates](#sources-for-lead-ad-candidates).

**4. Choose whether to send an invitation**

**Send application invitation email** is on by default. Each new candidate gets one email with a link to finish their application.

**5. Connect**

Click **Connect**.

> [!TIP]
>
> Turn the invitation email off for broad awareness campaigns where you'd rather screen leads before contacting them, and leave it on for campaigns aimed at people ready to apply.

To send a form's leads to a different job req later, use the same menu and pick the new job req. New leads go to the new job req; candidates already created stay where they are.

### Link a form from the job req

You can also work from the job req. Open it, go to **Setup**, then **Lead Ads**. The tab lists every form linked to this job req with its status, Page, source, when it was linked and when it last synced, plus the **Send application invitation email** switch for each form.

**1. Open the picker**

Click **Link a form**.

**2. Find the form**

Search by form name, ID or Page. **Available** lists forms that aren't linked yet; **Linked to other reqs** lists forms already feeding another job req.

**3. Link it**

Click **Link**. For a form on another job req, click **Link here**, then **Link to this job req** to move it. Future leads come to this job req instead; leads already brought in on the other job req aren't affected.

Each form's menu on the tab has **Edit field mapping**, **Edit source** and **Unlink**.

## Map the form's questions

Mapping tells Journeyfront where each answer on your lead form should go.

**1. Open the mapping**

In the form's actions menu, choose **Edit field mapping**.

**2. Review the suggestions**

Each form question is listed with a suggested destination. Contact questions like full name, email and phone are matched automatically, and questions whose wording matches a screening question on the job req are matched to that question.

**3. Adjust anything that's off**

Send an answer to a standard field, a [personal or application field](https://help.journeyfront.com/account-setup/custom-fields.md), a screening question on the job req, or choose **Don't import**. For multiple-choice questions, match each form answer to a Journeyfront answer.

**4. Save**

Name and email must be mapped before you can save. Click **Save mappings**.

![The Edit field mapping window for a lead form, with Full name, Email and Phone number mapped to standard fields, a weekend availability question mapped to a screening question with its Yes and No answers matched, a languages question mapped to a personal field, and one question set to Don't import](https://mintcdn.com/journeyfront/Ki8OScNKQAoeTHdj/images/sourcing/lead-ads/gen-field-mapping.png?fit=max\&auto=format\&n=Ki8OScNKQAoeTHdj\&q=85\&s=73250f76e2267e99df00e9534b78dafd)

* **Apply auto-map** appears when your choices differ from the suggestions. Click it to go back to the suggestions.
* Click the info icon next to a screening question to preview the full question before you map to it.
* If a question changes on the lead form later, its row is flagged so you know to check it. The other rows stay as they are.

> [!TIP]
>
> Map screening questions wherever you can. Candidates' answers then count toward screening right away, and they don't have to answer the same question twice.

That's it. The next lead submitted on that form becomes a candidate on the job req.

## Sources for lead ad candidates

By default, each lead's source is set from where it was submitted: **Meta Lead Ad - Facebook**, **Meta Lead Ad - Instagram**, **Meta Lead Ad - Messenger** or **Meta Lead Ad - Audience Network**. The form shows **Automatic** as its source.

To give every lead from a form one source of your own, for example to compare two campaigns, choose **Edit source** from the form's menu and pick it. The source then shows an **Override** badge. Sources are managed under **Settings**, then **Sources**.

> [card] [Sources](https://help.journeyfront.com/sourcing/sources.md)
>
> Add your own sources and see how a candidate's source gets set.

## Form statuses

The **Meta Lead Ads** page lists every form with its status. Hover over a status to see what it means for that form.

| Status | What it means |
| - | - |
| **Active** | Linked to a job req and has brought in a lead in the last 30 days. |
| **Silent** | Linked, but the last lead was more than 30 days ago. |
| **Connected** | Linked, but no leads yet. |
| **Needs mapping** | Linked, but name and email aren't mapped, so every lead fails. Open **Edit field mapping** and save. |
| **Unconnected** | Not linked to a job req, so its leads don't become candidates. |
| **Disabled** | Paused by your team. New leads aren't brought in. |
| **Archived** | Archived in Meta; it can't receive new leads. |

The list also shows each form's Page and a **Leads** count (imported out of received). A warning icon on the count means some leads haven't made it in; hover over it for details. Use the search box, the **Status** and **Page** filters, and **Refresh from Meta** to find what you need.

![The Meta Lead Ads page in Settings, with search, the Status and Page filters, View all logs and Refresh from Meta, and a list of lead forms showing each form's Page, status, linked job req, source, leads count and last lead](https://mintcdn.com/journeyfront/Ki8OScNKQAoeTHdj/images/sourcing/lead-ads/gen-forms-list.png?fit=max\&auto=format\&n=Ki8OScNKQAoeTHdj\&q=85\&s=a6df443e5d6691e9236f7ff4082da6c5)

## Check a form's health

Click a form's name (or **Open form** in its menu) to open its details panel. It has three tabs:

* **Overview:** the linked job req, source and invitation setting, lead counts, and the form's Page. Use **Edit field mapping** or **Edit source** from here.
* **Health:** click **Run health check** to check the whole path from the platform to Journeyfront for this form. Each check shows **OK**, **Check**, **Problem** or **Skipped**, with a suggested fix. The check also lists the most recent leads the platform has for the form and whether each one was received.
* **Logs:** the most recent lead deliveries for this form. Click **View all logs for this form** for the full log.

If the health check finds leads that never arrived, click **Import missing leads** (it shows the number, such as "Import 2 missing leads") to bring them in. Each import handles up to 200 leads; run it again for more.

To test the setup end to end, click **Send test lead** on the **Health** tab. A test lead is sent through the normal path. If the form is linked, a test candidate is created on the job req (and gets the invitation email if that's on). Delete the test candidate afterwards.

![A lead form's details panel on the Health tab: the health check results with one Problem and its fix, the most recent leads at Meta marked Received or Never received, and the Import 1 missing lead button](https://mintcdn.com/journeyfront/Ki8OScNKQAoeTHdj/images/sourcing/lead-ads/gen-form-health-tab.png?fit=max\&auto=format\&n=Ki8OScNKQAoeTHdj\&q=85\&s=d77fb1010d8fcb4b894a0448c6b72cdb)

## Fix common problems

| What you see | What to do |
| - | - |
| A banner saying a Page isn't subscribed, or **Not subscribed** next to a form's Page | Leads from that Page aren't reaching Journeyfront. Choose **Repair Page subscription** from the form's menu. See [Fix connection problems](https://help.journeyfront.com/integrations/meta-lead-ads.md#fix-connection-problems). |
| A banner listing forms that are receiving leads but aren't linked | Link each form to a job req, then choose **Retry failed leads** from its menu (it shows the number of leads, such as "Retry 3 failed leads") to bring in the leads that already arrived. |
| **Needs mapping** | Open **Edit field mapping**, make sure name and email are mapped, and click **Save mappings**. |
| A warning icon on a form's **Leads** count | Open the form and run the health check on the **Health** tab. |
| 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](https://help.journeyfront.com/integrations/meta-lead-ads.md#allow-journeyfront-in-leads-access), then click **Import missing leads**. |

> [card] [Meta Lead Ads](https://help.journeyfront.com/integrations/meta-lead-ads.md)
>
> Fix connection problems on the Meta side, such as Page subscriptions, permissions and Leads Access.

## Review the lead log

Go to **Settings**, then **Meta Lead Ads**, and click **View all logs**. Every lead delivered to Journeyfront is logged with its status, contact details, form and job req. To see one form's leads, choose **View Logs** from that form's menu.

* Filter by status (successes or failures), by when the lead was received, or search by email, name or form.
* Click **Download CSV** to download the filtered log.
* Open a row's actions menu and choose **View lead details** to see the lead's answers, campaign, ad and platform, read live from the platform.
* Choose **Retry** to process a failed lead again once you've fixed the cause. It's treated like a new submission: the candidate is created and gets the invitation email if that's on.

Common statuses:

| Status | What it means |
| - | - |
| **Success** | The candidate was created. |
| **Received** | The lead arrived and is being processed. |
| **Missing info** | The lead didn't include a first name, last name and email, which Journeyfront needs to create a candidate. |
| **Duplicate** | The person already has an application on that job req, so no second one was created. |
| **No mapping** | The form isn't linked to a job req. Link it, then retry. |
| **Form disabled** | The form was paused when the lead arrived. Activate it, then retry. |

![The Meta Lead Ads Logs page with search, the Status and Received filters and Download CSV, a list of lead deliveries with their status, candidate, form, linked job req and detail, and a failed lead's menu open to View lead details and Retry](https://mintcdn.com/journeyfront/Ki8OScNKQAoeTHdj/images/sourcing/lead-ads/gen-lead-log.png?fit=max\&auto=format\&n=Ki8OScNKQAoeTHdj\&q=85\&s=0ec3af32a0b49a4f25da6c8b48ef0a7d)

## Pause or unlink a form

To pause new leads from a form, for example while a campaign is on hold, choose **Disable** from its menu. New leads are logged as **Form disabled** and don't become candidates. Choose **Activate** to start again.

Disabling keeps the link to the job req. To remove the link, choose **Unlink from job req** from the form's menu, or **Unlink** from the form's menu on the job req's **Lead Ads** tab. Future leads from the form stop creating candidates on that job req, and you can link it again any time.

> [!TIP]
>
> Leads that arrive while a form is disabled are still logged. After you activate the form, you can retry them from the log so no one is lost.

## Where lead details show on a candidate

Lead ad candidates appear on the linked job req like any other applicant. On their Candidate Application's **Details** tab you'll see the **Source** and where the lead came from: the platform, lead form, campaign, ad set and ad, and when they submitted. Answers mapped to screening questions appear with the candidate's other screening results.

## What candidates see

If the invitation email is on, the candidate gets one email (not a series) with a link to finish their application. The link works for 30 days and signs them in, and the answers they gave on the lead form are already filled in, so they only complete what's left.

## FAQ

> [accordion] Does this work for Instagram lead ads too?
>
> 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.

> [accordion] How quickly do candidates appear?
>
> Usually within seconds. Each lead is sent to Journeyfront as soon as it's submitted.

> [accordion] Will candidates get a lot of emails?
>
> No. The invitation is a single email, and you choose for each form whether it's sent.

> [accordion] What happens to leads from a form that isn't linked yet?
>
> They're logged as **No mapping** and don't become candidates. After you link the form, choose **Retry failed leads** from its menu to bring them in. Leads submitted before you connected Meta at all aren't brought in.

> [accordion] Can one lead form feed more than one job req?
>
> Not at the same time. A form links to one job req. If you move it to a different job req, new leads go there.

> [accordion] What if we change a question on the lead form?
>
> Journeyfront checks your forms daily. Changed or new questions are flagged in the mapping editor so you can review them; the rest of the mapping stays in place.

> [accordion] Can Journeyfront create lead forms or ads for us?
>
> No. You build lead forms and ads in the platform's ads manager. Journeyfront brings in the forms from the Pages you connect, and can't post to your Page or change your ads.

> [accordion] How is this different from job boards?
>
> Job boards send your job postings out to people browsing job sites. Lead ads bring people in from the social ads you're already running. Both end up as Candidate Applications on your job reqs.

## Related

> [card] [Meta Lead Ads](https://help.journeyfront.com/integrations/meta-lead-ads.md)
>
> Connect your Meta Business account and Pages.

> [card] [Social media](https://help.journeyfront.com/sourcing/social-media.md)
>
> Every way candidates reach you from social media.

> [card] [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md)
>
> Create the personal fields you map lead form answers to.

> [card] [Job boards](https://help.journeyfront.com/integrations/job-boards.md)
>
> Post your job reqs where candidates are looking.

> [card] [Employee referrals](https://help.journeyfront.com/referrals/overview.md)
>
> Let employees refer people they know.

> [card] [Integrations overview](https://help.journeyfront.com/integrations/overview.md)
>
> Everything Journeyfront connects to.


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