Facebook Lead Ads Integration and Troubleshooting in Sparkforge

The Facebook Lead Ads integration pulls leads from your Facebook Ads campaigns into Sparkforge automatically. Once connected, every lead form submission creates or updates a contact, optionally fires a workflow, and shows up in your CRM in seconds.

Who benefits from this integration

• Small businesses running Facebook Lead Ads without a dedicated marketing team.
• Service businesses that need fast follow-up on inbound leads.
• Agencies running ads on behalf of multiple clients.
• Existing Sparkforge users who want lead capture and CRM in one place.

What the integration does

• Imports new leads instantly when forms are submitted.
• Maps Facebook form fields to Sparkforge contact fields.
• Triggers workflows like welcome emails, SMS, or sales follow-up.
• Tracks lead source and ad campaign for reporting.

Prerequisites

• Admin access to the Facebook Page tied to the ads.
• Admin or appropriate access in the Facebook Business Manager.
• An active Sparkforge subaccount with workflow and contact permissions.

Supported custom fields

Sparkforge auto-maps standard Facebook fields like first name, last name, email, and phone. Custom Facebook form fields can be mapped to Sparkforge custom fields of matching types: text, number, dropdown, multi-select, date, and checkbox.

How to connect Facebook Lead Ads

1. Open the subaccount and go to Settings > Integrations.
2. Find Facebook and click Connect.
3. Authorize Sparkforge with your Facebook account — grant page and lead access permissions.
4. Select the Facebook Pages you want to connect.
5. For each Page, map form fields to Sparkforge contact and custom fields.
6. Save the integration.

Troubleshooting

Leads are not arriving in the subaccount

• Verify the Facebook Page is still connected on the Integrations screen.
• Check that the Facebook user who authorized the integration still has admin access to the Page.
• Confirm the lead form is published and active in Facebook Ads Manager.
• Reauthorize the integration if it shows a warning state.

Token expired error

Facebook tokens expire roughly every 60 days, sooner if the authorizing user changes password, loses Page admin rights, or has security checks triggered. Fix it:

1. Open Settings > Integrations > Facebook.
2. Click Reconnect.
3. Re-authorize with a user who has admin access to the Page.
4. Re-confirm field mappings — they usually persist but verify before going live.

Page Quality Issue

Facebook may flag a Page for quality problems, which blocks lead delivery. Fix Page Quality issues directly in Facebook Business Manager before reconnecting Sparkforge.

Permission Issue

If reauth shows a permission error, the connecting user no longer has the access they need. Have a Page admin reauthorize the integration.

Instagram or Messenger messages not syncing

• Confirm the Instagram account is connected to the Facebook Page in Meta Business Suite.
• Verify the integration scope includes messaging permissions.
• Reauthorize the integration if scopes were updated.

Missing Pages on connect

If the Page list is empty or incomplete, the connecting Facebook user lacks admin access to the missing Pages. Resolve in Business Manager, then reconnect.

Using third-party connectors

If direct integration is blocked for any reason, you can route Facebook leads through a webhook from Pabbly Connect or a similar workflow tool into Sparkforge's inbound webhook. The direct integration is preferred where possible — fewer hops mean fewer failure points.