# Facebook Lead Ads

> Facebook Lead Ads sync automatically brings Facebook lead form submissions into Mailrith. This guide explains Page connection, lead form setup, tags, sequences, older lead import, activity, and subscriber safety rules.

- Human page: https://mailrith.com/docs/facebook-lead-ads
- Category: Forms & Landing Pages
- Reading time: 10 min read

## What this guide covers
Connect Facebook Pages, choose where lead form answers go, add tags, start sequences, import older leads, and review lead activity.

## Sections
- What Facebook Lead Ads Sync Does
- Before You Start
- Connect a Facebook Page
- Configure Lead Form Setup
- Older Leads and Activity
- Subscriber Results and Safety

## What Facebook Lead Ads Sync Does

Facebook Lead Ads sync brings people who submit a Facebook lead form into Mailrith automatically. Each connected Facebook Page can have one or more lead forms. In Mailrith, you decide how each form should create or update subscribers.

Each lead form setup can save the subscriber's email and name, send extra answers into Mailrith custom fields, add tags, start sequences, and keep Facebook campaign and ad details in the lead activity history. This lets you follow up quickly without exporting CSV files from Facebook.

If the same email address already exists in the workspace, Mailrith updates that subscriber instead of creating a duplicate. Unsubscribed subscribers can be marked Active again if you allow it in the lead form setup. Blocked, bounced, and complained subscribers stay protected and are skipped.

## Before You Start

Facebook Lead Ads sync needs both Mailrith setup and Facebook setup. If your Mailrith account is hosted by Mailrith, the Facebook app setup is handled centrally. If you run your own Mailrith deployment, finish the Facebook app setup before users can connect Pages.

- You need access to the Mailrith workspace where the leads should be added.
- The workspace needs Mailrith Pro, and you need permission to manage Facebook Lead Ads in that workspace.
- You need access to the Facebook Page that owns the lead forms.
- Your Facebook app needs approval for the Page and lead access that Facebook asks for during setup.
- If the Page uses Facebook's Leads Access Manager, make sure the person connecting the Page is allowed to access leads for that Page.

Facebook may require app review before live Pages can provide lead data. If the connection succeeds but no leads arrive, check the Facebook app mode, approved permissions, Page access, and the Page's lead access settings.

## Connect a Facebook Page

1. Open Mailrith and use the workspace switcher in the left sidebar to choose the workspace that should receive the leads.
2. In the left sidebar, click **Integrations**.
3. On the Facebook Lead Ads card, click **View**.
4. Click **Connect Facebook Page**.
5. Facebook opens an authorization screen. Sign in with the Facebook account that has access to the Page.
6. Approve the requested Facebook access so Mailrith can find your Pages, import lead form submissions, and read ad details when Facebook provides them.
7. After Facebook sends you back to Mailrith, choose the Page in **Choose Facebook Page**.
8. Enter a clear **Connection Name**, such as "Main Facebook Page Lead Ads".
9. Click **Connect Page**.

Mailrith then connects to the Page and imports the Page's current lead forms. If the Page has no lead forms yet, create or publish the forms in Facebook and then click **Refresh** on the Mailrith connection.

## Configure Lead Form Setup

Each Facebook form has its own setup. This is important because different forms often ask different questions or need different follow-up tags and sequences.

1. Go to **Integrations** and open **Facebook Lead Ads**.
2. Find the connected Facebook Page.
3. In the form table, find the form you want to configure.
4. Click **Configure**.
5. Keep **Turn on automatic import for this form** turned on if new leads from this form should enter Mailrith.
6. In **Form Answers**, save the Facebook email answer as **Email**.
7. Save the Facebook name answer as **Name** if the form collects a name.
8. For extra Facebook answers, choose **Custom Field** and then select the matching Mailrith custom field.
9. Choose **Ignore** for Facebook fields you do not need in Mailrith.
10. Choose the **New Subscriber Status**. Most lead forms should use **Active** unless a double opt-in process should keep people unconfirmed first.
11. Choose whether unsubscribed subscribers should be marked Active again when they submit this Facebook form.
12. Choose whether Mailrith should store Facebook campaign and ad details for troubleshooting and reporting context.
13. Select any tags to add after the lead is imported.
14. Select any sequences to start after the lead is imported.
15. Click **Save Lead Form Setup**.

If a selected tag uses double opt-in, Mailrith follows that tag's confirmation rules. If the subscriber must confirm first, Mailrith queues the confirmation email instead of treating the subscriber as fully active immediately.

## Older Leads and Activity

New leads arrive automatically from Facebook. Older lead import is for leads that were already in a Facebook form before the Mailrith connection was created or before a lead form setup was turned on.

1. Go to **Integrations** and open **Facebook Lead Ads**.
2. Find the connected Facebook Page and the form you want to import from.
3. Click **Import Older Leads** on that form row.
4. Wait for Mailrith to import the older leads in the background.
5. Click **View Activity** on the connection to see recent lead activity.
6. If a lead failed because of a temporary issue, click **Retry** on that lead or **Retry Failed Leads** for the connection.

Activity shows whether a lead was imported, skipped, waiting, or failed. A skipped lead is not always an error. For example, Mailrith skips leads when the lead form setup is turned off, when the subscriber is blocked, bounced, or complained, or when required data such as a valid email is missing.

## Subscriber Results and Safety

- **New lead:** Mailrith creates a subscriber, saves selected answers, adds selected tags, starts selected sequences, and records the lead source.
- **Existing active subscriber:** Mailrith updates the name and selected custom fields, adds any missing selected tags, and starts selected sequences that are not already assigned.
- **Existing unsubscribed subscriber:** Mailrith only marks them Active again when the lead form setup allows it.
- **Blocked, bounced, or complained subscriber:** Mailrith skips the lead to protect sending reputation and compliance.
- **Missing or invalid email:** Mailrith marks the event failed or skipped because an email address is required to create or update a subscriber.

After testing a new setup, open [Subscribers](https://mailrith.com/docs/subscribers.md), search for a test lead, and check the subscriber profile. Confirm the status, tags, custom fields, sequences, and activity history match the setup you saved.

## Related Guides
- [Subscribers](https://mailrith.com/docs/subscribers.md): The Subscribers page is the operating hub for your audience — search, status filtering, bulk actions, CSV imports and exports, and per-subscriber activity timelines all live here.
- [Custom Fields](https://mailrith.com/docs/custom-fields.md): Custom fields are the shared data schema for your workspace — define them once and they become available across subscriber records, forms, segmentation rules, automation conditions, and email merge variables.
- [Tags](https://mailrith.com/docs/tags.md): Tags are the fastest way to categorize subscribers — apply them through imports, forms, automations, and magic links, then use them as targeting filters across every send surface in Mailrith.
