Facebook Lead Ads

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