Who This Is For / When to Use
This setup is for advertisers and marketers who use Facebook or Instagram Instant Forms and want Meta to optimize ads for lead quality instead of lead volume.
Use this integration when leads are captured in Kyrios and progress through pipeline stages that represent real sales intent.
What the Facebook Conversion API Does
The Meta Conversion API allows Kyrios to send server-side conversion events directly to Facebook.
Instead of relying on browser-based tracking, Kyrios acts as the primary data source and shares lead status changes with Meta so ad delivery can optimize for downstream conversions.
Funnel Events vs Lead Events
Funnel Events
Funnel Events are server-side website actions triggered by user activity on a website.
Examples include page visits, form submissions, add-to-cart actions, purchases, and subscriptions.
Lead Events
Lead Events are triggered by pipeline activity inside Kyrios.
When a contact moves between pipeline stages such as New Lead, Booked, or Qualified, Kyrios sends that event to Facebook CAPI.
Prerequisites Before Setup
Before starting, confirm the following:
Your Facebook account is connected in Settings > Integrations
You have admin access to the Facebook Page and Ad Account
Facebook Lead Forms are connected
Facebook Form Field Mapping is completed in Account Settings > Integrations > Facebook Form Field Mapping
Step 1: Initialize a Meta Pixel (Dataset)
Access Events Manager
Open Meta Business Suite and navigate to Events Manager.
Confirm the correct Ad Account is selected.
[Screenshot: unnamed (6).png]
Connect a Data Source
Click Connect Data, choose CRM, and click Next.
Choose CRM Integration Method
Select Use a third-party partner, choose LeadConnector, and click Go to partner.
Confirm CRM Partner
Search for LeadConnector, select LeadConnector (Recommended), and click Next.
Create or Select a Pixel
Choose an existing pixel or click Create new Pixel, then continue the setup.
Important Notes After Setup
If Meta displays “Wait for seven days of CRM events,” confirm that:
Events are sent daily
At least 50 real (non-test) events occur within 7 days
At least two pipeline stages are sending events
Step 2: Create Two Required Workflows
Two workflows are required and both must be published.
Workflow 1: Capture Facebook Leads into a Pipeline
Create Workflow Trigger
Go to Automations > Workflows, create a new workflow, and select the trigger Facebook Lead Form Submitted.
Apply Trigger Filters
Apply filters to target the correct Facebook Page or Lead Form.
Create or Update Opportunity
Add either a Create Opportunity or Update Opportunity action.
Configuration requirements:
Select the correct Pipeline
Set the initial Pipeline Stage
Set Opportunity Name to the contact’s full name
Enable Allow Duplicate Opportunities
Enable Workflow Settings
Turn on Allow Re-Entry, save all actions, and publish the workflow.
Workflow 2: Send Lead Events to Facebook CAPI
Create Pipeline Stage Trigger
Create a second workflow with the trigger Pipeline Stage Changed and select the pipeline and stage.
Add Facebook Conversion API Action
Add the Facebook Conversion API action and set the Event Type to Lead Event.
Configure Facebook Conversion API Fields
Complete the following fields:
Access Token
Pixel ID (Dataset ID)
Facebook Event Name (example: Lead)
Optional Value and Currency
Custom Value Mapping (Optional)
Enable Custom Mapping if you want to override default values.
You can map:
FBCLID for funnel events
Facebook Lead ID for lead events
If left blank, Kyrios uses system defaults.
Save and Publish
Save the action, enable Allow Re-Entry, and publish the workflow.
Where to Find Access Token and Pixel ID
Access Token
In Events Manager, go to Data Sources > Settings, click Generate Access Token, and copy the token into Kyrios.
Pixel ID (Dataset ID)
In the same Settings section, copy the Dataset ID and paste it into the Pixel ID field in Kyrios.
Testing the Integration
Use the Lead Ads Test Tool to submit a test lead.
Move the test lead to another pipeline stage and check:
Workflow execution logs in Kyrios
Events appearing in Events Manager
Events can take up to 24 hours to display.
Monitoring Progress in Meta
Use Events Manager > Settings to review:
CRM event status
Funnel progression
Diagnostics and warnings
[Screenshot: unnamed (6).png]
Common Issues and Fixes
Facebook Conversion API Action Is Skipped
Error: No attribution data found
Fixes:
Add the Facebook Pixel code directly to the funnel page head tracking section
Verify workflow triggers are correct
Confirm real (non-test) events are firing
FAQ
What is the Meta Conversion API (CAPI)?
The Meta Conversion API sends server-side events from Kyrios to Facebook to improve tracking accuracy and ad optimization.
How does CAPI improve Facebook Lead Ads?
As leads move through Kyrios pipeline stages, their status is sent to Meta so ads can optimize for higher-quality conversions instead of lead volume.
Where do I find my Access Token and Pixel ID?
Both are located in Events Manager > Data Sources > Settings.
What is Custom Value Mapping?
It allows manual assignment of FBCLID or Facebook Lead ID. If enabled, these values override Kyrios defaults.
Can I use an existing Facebook Pixel?
Yes. Using an existing pixel is recommended because it already contains historical data.
How do I confirm events are working?
Check workflow execution logs in Kyrios and CRM event status in Meta Events Manager.