Who This Is For / When to Use
This article is for Kyrios users whose Facebook Lead Ads are not appearing, not syncing leads, showing errors, or failing during testing.
How Facebook Lead Ads Work in Kyrios
Kyrios connects to Facebook Lead Ads through an authorized Facebook app and webhook subscription that sends lead data in real time.
If the connection, permissions, domain context, or form mappings are incorrect, forms may not appear or leads may fail to sync.
How to Check Facebook Form Field Mapping
Facebook Lead Ads must be mapped correctly in Kyrios for lead data to be captured.
To access form field mapping:
Go to Settings (bottom-left).
Select Integrations.
Open Facebook Form Fields Mapping.
If the Form List Is Blank
If no forms appear, the Facebook page connection must be refreshed.
Steps:
Copy the current URL from your browser.
Open an Incognito window.
Paste the URL into the address bar.
Replace the end of the URL with
facebook_page_select.Press Enter.
This opens the Facebook page selection dialog.
Re-select the correct Facebook page.
Click Connect page.
Once complete:
Return to Facebook Form Fields Mapping.
Refresh the page or toggle the integration off and on.
If forms appear:
Ensure each form is mapped.
Confirm the status shows as active.
How to Fix Facebook Connection Issues That Keep Spinning
A continuously loading or spinning connection screen usually indicates a domain mismatch.
To resolve:
Confirm the current Kyrios URL domain in your browser.
Go to Settings > Business Profile > Branded Domain.
Verify the branded domain matches the domain used during Facebook login.
The domains must match exactly for the connection page to load correctly.
How to Verify Lead Data Using Facebook Lead Ads Testing Tool
Facebook provides a testing tool to confirm whether lead data is being sent successfully.
Steps:
Open the Facebook Lead Ads Testing Tool.
Select the correct Facebook page.
Select the relevant lead form.
Review the App ID list and confirm the Kyrios app is present.
Click Create lead to generate a test lead.
Click Track status.
A successful test shows:
Status: success
HTTP Code: 200
How to Diagnose Errors in Test Leads
If test leads fail, error details will appear in the testing tool.
To review errors:
Click Track status.
Check the Error Code and Error Message columns.
Common causes include:
Removed app permissions
Facebook page access changes
App disconnected in Facebook Business Manager
If errors are present, re-add or re-authorize the Kyrios app in Facebook Business Manager.
Common Issues and Fixes
Forms Are Not Appearing in Kyrios
Cause: Facebook page connection is stale or expired.
Fix: Reconnect the page using the facebook_page_select method and refresh the mapping page.
Leads Are Not Syncing
Cause: App permissions were removed or webhook subscription failed.
Fix: Use the Facebook Lead Ads Testing Tool and re-add the Kyrios app if errors appear.
Incorrect or Missing Field Mapping
Cause: Forms were not mapped or saved as active.
Fix: Edit the form mapping, ensure all required fields are mapped, and save to activate.
Frequently Asked Questions
Why are my Facebook forms not appearing in Kyrios?
This usually happens due to a connection issue. Refresh the Facebook page connection and reload the form field mapping screen.
What should I do if the connection page keeps spinning?
Verify that the branded domain in Kyrios matches the domain used during Facebook login.
How can I test whether my Lead Ads are working?
Use the Facebook Lead Ads Testing Tool to create test leads and confirm a success (200) status.
What if test leads are not showing in Kyrios?
Check the App ID and permissions in Facebook Business Manager and re-add the Kyrios app if necessary.
How can I prevent future Lead Ads issues?
Regularly test lead forms, verify permissions, and confirm mappings remain active.