Facebook Lead Ads

What Facebook Lead Ads Sync Does

Facebook Lead Ads sync automatically adds people who submit a Facebook lead form to Mailrith. Each connected Facebook Page can have one or more lead forms. In Mailrith, you choose how each form creates new subscribers or updates existing subscribers.

Each lead form setup can save the subscriber's email address and name, send extra form answers to Mailrith custom fields, add tags, start sequences, and store Facebook campaign and ad details in the lead activity history. This helps 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 subscriber record. Mailrith can mark unsubscribed subscribers Active again only when you allow that behavior in the lead form setup. Blocked, bounced, and complained subscribers stay protected, so Mailrith skips those leads.

Before You Start

Facebook Lead Ads sync requires setup in both Mailrith and Facebook. If Mailrith hosts your account, Mailrith manages the Facebook app setup centrally. If you run your own Mailrith deployment, complete the Facebook app setup before users try to connect Pages.

• You need access to the Mailrith workspace where Mailrith should add the leads.
• The workspace needs an active paid plan, and you need Manage Integrations access to connect or change Facebook Lead Ads.
• You need access to the Facebook Page that owns the lead forms.
• Your Facebook app needs approval for the Page access and lead access that Facebook requests during setup.
• If the Page uses Facebook's Leads Access Manager, confirm that the person connecting the Page is allowed to access leads for that Page.

Facebook may require app review before live Pages can send lead data to Mailrith. If the connection succeeds but no leads arrive, check that the Facebook app mode allows live lead access, the required permissions are approved, the connected Facebook account can access the Page, and the Page's lead access settings allow that account to read leads. The setup is working when Mailrith receives a new test lead from that Page.

Connect Facebook Pages

1. Open Mailrith and use the workspace switcher in the left sidebar to choose the workspace that should receive the leads by default.
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, receive lead form submissions, and read ad details when Facebook provides them.
7. After Facebook sends you back to Mailrith, select one or more Facebook Pages whose leads should be added to Mailrith.
8. Choose the Mailrith workspace where Mailrith should add those leads. The workspace you started from is selected by default.
9. Click Connect Page or Connect Pages.

Mailrith connects the selected Pages to the selected workspace and loads the current lead forms from each Page. If a Page has no lead forms yet, create or publish the forms in Facebook first, then return to the Mailrith connection and click Refresh.

When you select several Pages, Mailrith reports which Pages connected and which Pages still need attention. Successfully connected Pages appear immediately. A Page that failed stays selected in the setup window so you can correct its Facebook Page or lead access and try again without reconnecting the successful Pages.

If Mailrith temporarily cannot prepare the Page selection after Facebook sends you back, click Retry Facebook Setup. Mailrith keeps the successful Facebook authorization available for the retry. Start the Facebook connection again only if Mailrith says the setup expired.

The Facebook Lead Ads page shows connected Pages from the workspaces you can access. The Workspace column shows where Mailrith will create or update subscribers from each Page's leads. To send another Page's leads to a different workspace, connect that Page again and choose the other workspace during setup.

Configure Lead Form Setup

Configure each Facebook form separately 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 in the table and click its row.
3. In the form table, find the form you want to configure.
4. In the Actions column, click the Configure icon.
5. In Form Answers, map the Facebook email answer to Email.
6. Map the Facebook name answer to Name if the form collects a name.
7. For extra Facebook answers, choose the matching Mailrith custom field in the Mailrith Field column. Each custom field can be used for only one Facebook answer in the same form setup.
8. Choose Do not map for Facebook fields you do not need to save in Mailrith.
9. Choose the New Subscriber Status. Most lead forms should use Active unless your team intentionally wants imported leads to start in another status.
10. Choose whether Mailrith should mark unsubscribed subscribers Active again when they submit this Facebook form.
11. Choose whether Mailrith should store Facebook campaign and ad details in lead activity for troubleshooting and reporting context.
12. Select any tags to add after Mailrith imports the lead.
13. Select any sequences to start after Mailrith imports the lead.
14. Click Save.
15. Return to the form table and find the Automatic Import column.
16. Turn on Automatic Import when new leads from this form should enter Mailrith.

Facebook Lead Ads sync can add tags and start sequences, but it does not currently send form or landing-page double opt-in confirmation emails. Use a Mailrith form or landing page when that signup path must require confirmation before the Subscriber becomes Active.

New Facebook forms start with automatic import off so you can review their setup before any leads enter Mailrith. Automatic import requires exactly one Facebook answer mapped to Email. After you map a custom field, Mailrith makes it unavailable in the other answer rows so two Facebook answers cannot overwrite or invalidate the same subscriber value. Mailrith does not save answers mapped to Do not map. When one Facebook question allows several answers, map it to a Multi Select custom field to keep every selected answer.

Keep the choices in mapped Mailrith fields aligned with the answers Facebook can send. Mailrith prevents you from removing a custom field choice while a Facebook form maps answers to that field. Open the named Facebook Page and form, update or remove the mapping, then return to Custom Fields and save the choice change again.

The form table shows whether the form is still available in Facebook separately from whether automatic import is on in Mailrith. An archived or unavailable Facebook form cannot be turned on or used for an older lead import. Restore the form in Facebook, return to its connected Page in Mailrith, and click Refresh before using it again.

Older Leads and Activity

Mailrith receives new leads automatically from Facebook. Use older lead import for leads that were already in a Facebook form before you created the Mailrith connection or before you turned on the lead form setup.

1. Go to Integrations and open Facebook Lead Ads.
2. Find the connected Facebook Page and the available form that contains the older leads. Automatic import must be on for that form.
3. In the Actions column, click the Import Older Leads icon on that form row.
4. Mailrith shows an Import Started message. Click Got It.
5. Wait while Mailrith imports the older leads in the background. Mailrith emails you when the import is complete.
6. If Facebook does not allow Mailrith to finish the import, Mailrith emails you with the reason and asks you to check the Facebook Page connection.
7. In the Actions column, click the View Activity icon on that form row to see recent lead activity for that form.
8. If one lead failed because of a temporary issue, click Retry on that lead.
9. If many leads failed, click Retry All Failed Leads in the activity drawer. Mailrith shows a Retry Started message and emails you when the retry is done.

Activity shows whether Mailrith imported, skipped, queued, or failed each lead. A skipped lead is not always an error. For example, Mailrith skips leads when the lead form setup is turned off or when the subscriber is blocked, bounced, or complained. Missing or invalid lead information fails only that lead and does not stop Mailrith from accepting later submissions from the same Facebook Page.

Mailrith removes older Facebook answer details after the normal activity retention period to limit stored data. A processed lead still shows the subscriber's current email when that subscriber remains in the workspace. If no subscriber was created and the older answer details are no longer stored, activity shows Lead details no longer stored instead of suggesting that Facebook sent no email.

Mailrith waits between retries when Facebook has a temporary problem. If the final automatic retry does not work, Mailrith marks the lead as Failed instead of leaving it queued. Open View Activity and click Retry after the temporary problem is resolved. A user-requested retry receives a fresh, limited set of delayed attempts.

After the first older lead import, Mailrith stops later imports when it reaches leads covered by the previous import. Existing lead records still prevent duplicates if the import pages overlap.

Mailrith runs one older lead import or failed lead retry at a time for each form. While that work is in progress, the form setup, older lead import, and retry actions are unavailable. They become available automatically after the background work finishes.

Disconnect A Facebook Page

You can disconnect an existing Facebook Page even after your paid plan ends. Mailrith pauses lead importing and keeps the other Facebook Lead Ads controls unavailable, but the connected Pages and their Disconnect actions remain visible.

1. Go to Integrations and open Facebook Lead Ads.
2. Find the connected Facebook Page. On a paid plan, click its row and then click Disconnect. After a downgrade, click Disconnect in the Page's Actions column.
3. Read the confirmation message. Disconnecting stops new lead imports and removes the saved form mappings for that Page.
4. Click Disconnect Facebook Page to confirm, or click Cancel to keep the connection.

When this is the last Mailrith connection using the Facebook Page, Mailrith also asks Facebook to stop sending lead notifications. If another Mailrith workspace still uses the Page, Facebook notifications stay connected for that workspace.

If Mailrith removes the local connection but Facebook does not confirm that notifications stopped, Mailrith shows Check Facebook Page Access. Open Meta Business Suite, choose the Page, open Settings, then review Integrations or Business Integrations and remove Mailrith if it is still listed.

Reconnect Facebook Access

Mailrith shows Needs Attention when Facebook no longer allows Mailrith to read leads from a Page. Mailrith shows Reconnect Recommended when the Meta authorization belongs to a removed Team Member. A temporary Facebook problem may make a Refresh action fail, but it does not change a healthy Page to Needs Attention. Processing older lead information already stored in Mailrith does not remove a Facebook access warning; Mailrith removes that warning only after Facebook access works again.

Reconnecting the same Page does not import the same Facebook lead twice. Mailrith recognizes leads it already received in that workspace and continues from the existing lead activity record.

1. Click Integrations in the left sidebar and open Facebook Lead Ads.
2. Find the Page marked Needs Attention or Reconnect Recommended and click its row.
3. Click Reconnect Meta Account.
4. Sign in to Meta with an appropriate administrator who can access the Page and its leads.
5. Approve the requested access. Mailrith shows the Page and workspace you chose to reconnect.
6. Confirm the Page and workspace, then click Reconnect Page.
7. Return to the Page and confirm that the warning is no longer shown.

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 keeps the subscriber's current status, 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 marks the subscriber Active again only when the lead form setup allows that change.
• Blocked, bounced, or complained subscriber: Mailrith skips the lead to protect sending reputation and compliance.
• Missing or invalid email: Mailrith marks that lead as failed because an email address is required to create or update a subscriber. Later valid leads continue importing normally.

After testing a new setup, open Subscribers, search for a test lead, and check the subscriber profile. Confirm that the status, tags, custom fields, sequences, and activity history match the setup you saved.