Help Guide Estimated setup time: 10-15 minutes

Meta CRM Conversions API (CAPI) Setup Guide

Getting plenty of Facebook leads but too many never become real opportunities?

Most Facebook Lead Ads campaigns optimise for people who submit forms, not people who become customers.

After someone submits a Facebook Lead Form, the real sales process usually happens offline through phone calls, SMS, quotes, appointments, and follow-up conversations.

Without CRM feedback, Meta often cannot tell:

  • which leads became qualified
  • which leads answered the phone
  • which leads booked appointments
  • which leads became customers

LeadSavvy closes that feedback loop by sending real pipeline outcomes back to Meta using CRM Conversions API.

This helps Meta gradually learn which leads actually become genuine opportunities and customers, not just cheap form submissions.

Meta Business Account Events Manager Access LeadSavvy GROW or SCALE Offline CRM Events Built for Facebook Lead Ads
Designed specifically for Facebook Lead Ads and Instant Forms workflows.
Meta reports that advertisers using Conversions API have seen an average 17.8% lower cost per result compared to advertisers not using Conversions API. Results vary by account, campaign setup, data quality, and lead volume.
What CRM CAPI helps Meta learn
  • Meta can optimise beyond simple form submissions
  • Help Meta learn which leads become real opportunities
  • Send offline CRM pipeline outcomes back automatically
  • Improve optimisation using real customer feedback loops
  • Keep CRM conversion tracking separate from website pixel activity

Why this matters

If you are getting plenty of Facebook leads but too many of them are poor quality, Meta may not have enough feedback about which leads actually turn into real opportunities or customers.

LeadSavvy's CRM CAPI feature helps close that feedback loop. When leads move through your pipeline, LeadSavvy can send those CRM outcomes back to Meta so your campaigns can optimise toward leads that are more likely to convert.

Meta says Conversions API for CRM can help improve lead quality by sharing CRM lead outcome data back to Meta. Meta also reports that advertisers using Conversions API have seen a 17.8% lower cost per result. Results vary by account, campaign setup, budget, data quality, and pipeline usage.

Improve lead quality

Help Meta learn which leads become real opportunities.

Reduce wasted spend

Optimise toward better outcomes, not just cheaper form fills.

Train the algorithm

Send real pipeline signals back to Meta automatically.

LeadSavvy Pro offline CRM CAPI overview
LeadSavvy Pro CRM CAPI overview showing how offline pipeline outcomes feed back into Meta optimisation.

What is CRM CAPI?

Meta CRM Conversions API allows LeadSavvy to send lead outcome events directly to Meta, including offline events that happen after a Facebook lead form is submitted. Instead of only optimising from form submissions, clicks, or website visits, Meta can also learn which leads became qualified, progressed through your pipeline, or ultimately became customers.

This is different from a website pixel. A pixel mainly tracks website activity. CRM CAPI helps send real pipeline outcomes from your CRM back to Meta.

Recommended best practice

Create a dedicated dataset specifically for LeadSavvy CRM events rather than reusing an existing website pixel dataset.

Recommended dataset name: LeadSavvy CRM Events

Why offline CRM events matter

LeadSavvy is built for businesses that use Facebook Instant Forms and Lead Ads.

With Facebook Lead Ads, the lead usually does not buy online straight away. Instead, the real sales process often happens after the form is submitted.

Common follow-up steps include:

  • phone calls
  • SMS messages
  • emails
  • appointments
  • quotes
  • consultations
  • manual sales follow-up

This creates a tracking problem.

A normal website pixel can track website activity, but it usually cannot tell Meta what happened after your team followed up with the lead.

For example:

  • Did the lead answer the phone?
  • Did they become qualified?
  • Did they book an appointment?
  • Did they request a quote?
  • Did they become a customer?

Without this feedback, Meta may keep optimising for people who are likely to fill in a form, not necessarily people who are likely to become good customers.

LeadSavvy helps close this gap by sending offline CRM events back to Meta when leads move through your pipeline.

This gives Meta better feedback about which leads are valuable, so your campaigns can optimise toward better quality leads over time.

Meta knows who submitted the lead form. LeadSavvy helps Meta learn what happened next.

Before you start

Meta access
  • Meta Business account
  • Access to Meta Events Manager
  • Admin access to datasets
  • You must have admin access to the Meta Business account and permission to manage datasets in Meta Events Manager
LeadSavvy access
  • LeadSavvy GROW or SCALE account
  • Access to LeadSavvy CAPI settings
  • A pipeline with meaningful stage names
1

Open Meta Events Manager

Go to Meta Events Manager and start a new CRM data source connection.

Meta Events Manager overview showing the Connect data entry points
The Events Manager overview screen where you start by clicking Connect data.
2

Connect a new data source

Inside Events Manager:

  1. Click Connect Data
  2. Choose CRM
Connect Data flow in Meta Events Manager with CRM selected
The Connect Data flow where you choose CRM as the data source.
Important: create a new dataset

At the bottom of the page, click Create New Dataset. Do not reuse an existing website pixel dataset for LeadSavvy CRM events.

Suggested dataset name: LeadSavvy CRM Events

Meta CRM setup page showing the Create New Dataset option near the bottom of the screen
The part of the CRM setup flow where Create New Dataset appears near the bottom of the screen.
3

Create the dataset

Enter a dataset name, ideally:

LeadSavvy CRM Events
Create New Dataset modal in Meta Events Manager with LeadSavvy CRM Events entered as the dataset name
The Create New Dataset modal with LeadSavvy CRM Events entered as the suggested dataset name.
4

Choose manual setup

  1. Open the Connect Manually tab
  2. Select Do the code manually yourself
  3. Click Next
Connect Manually tab in Meta Events Manager with Do the code manually yourself selected
The Connect Manually step with Do the code manually yourself selected.
5

Generate your access token

Scroll to 3. Create Endpoint and click Generate Access Token. Meta will show your dataset ID, access token, and an example endpoint URL.

Meta Create Endpoint section showing Generate Access Token, Dataset ID, and Access Token
The token generation area showing Generate Access Token, the dataset ID, and the access token.
Important: Meta copy button bug

Meta's Copy Access Token button often fails or copies the wrong thing.

  • Highlight only the access token value manually
  • Do not copy the full endpoint URL
  • You only need the token value itself, for example EAABxxxxxxxxxxxxxxxx
6

Copy your dataset ID and go back to settings

You need both the Dataset ID and Access Token for LeadSavvy.

After copying them, click Back to Settings at the very bottom right of the Events Manager page.

Meta Create Endpoint section showing both the Dataset ID and Access Token values to copy
Copy both the Dataset ID and the Access Token from the Create Endpoint section.
7

Configure the dataset allow list

Return to the dataset Settings page in Meta Events Manager, scroll to the bottom, find Traffic Permissions, then click Create Allow List.

Add these domains to the allow list:

app.leadsavvy.pro
leadsavvy.pro

For each domain, enter the domain name, click Next, then click Confirm.

Important: create the allow list

Create the allow list and add the LeadSavvy domains for this dataset. This helps reduce permission-related warnings and is designed to help CRM events continue processing correctly.

Traffic Permissions section in Meta Events Manager showing the Create Allow List action
The Traffic Permissions section where you click Create Allow List and begin entering the first domain.
Traffic Permissions allow list in Meta Events Manager with LeadSavvy domains added
The allow list after clicking Next and Confirm for each LeadSavvy domain.
8

Configure LeadSavvy Bridges

After copying your:

  • Dataset ID
  • Access Token

Return to LeadSavvy Pro.

  1. Open: Bridges
  2. Find the bridge you want to enable CRM CAPI for
  3. Click the: CAPI button on that bridge
  4. Enter: Dataset ID and Access Token
  5. Click: Test Connection

LeadSavvy will attempt to connect to Meta using the details provided. If successful, you should see a successful connection message.

  1. Click: Save

Repeat this process for each bridge you want to enable CRM CAPI on.

Bridge-by-bridge configuration

CRM CAPI settings are configured per bridge because different Facebook Pages or lead sources may use different Meta datasets.

You can test and enable CRM CAPI one bridge at a time.

LeadSavvy bridge CAPI settings showing Dataset ID, Access Token, Test Connection, and Save
The LeadSavvy bridge CAPI settings screen where you enter the Meta details, test the connection, and save.

How LeadSavvy sends CRM events

LeadSavvy automatically sends CRM events to Meta when a lead enters a pipeline stage. The event name is based on the pipeline stage name.

There is no manual event mapping required.

This does not mean every lead edit creates a new event. Renaming a stage, editing a lead, or making changes while a lead remains in the same stage should not be interpreted as a new CRM outcome event.

Pipeline Stage Name Event Sent to Meta
New Lead new_lead
Qualified qualified
Appointment Booked appointment_booked
Quote Sent quote_sent
Won won

In practice, the event name can be a normalized version of the pipeline stage name, such as lowercase text with spaces replaced by underscores.

Recommended pipeline stage naming

Good examples
  • New Lead
  • Qualified
  • Contacted
  • Appointment Booked
  • Proposal Sent
  • Won
Avoid
  • Vague abbreviations
  • Duplicate stages
  • Temporary admin stages
  • Unnecessary micro-stages
Best practice

Meta performs best when events represent meaningful business milestones. Focus on stages that indicate real lead progress, especially qualified leads, booked appointments, proposals sent, and successful sales. In most cases, your most valuable optimisation event will be your final conversion stage, such as Won. LeadSavvy CRM CAPI is designed around positive progression milestones rather than negative outcome events, so the strongest signals usually come from stages that show genuine movement toward a sale.

How long does it take to improve lead quality?

CRM CAPI is not instant. It works by giving Meta better feedback over time about which leads become genuine opportunities or customers.

As leads move through your LeadSavvy pipeline, Meta gradually learns which types of leads are more valuable to your business.

First few days
  • Events may begin appearing inside Meta Events Manager
  • Connection testing and initial event flow can be verified
  • You may not notice immediate lead quality changes yet
1-2 weeks
  • Meta starts building useful optimisation signals
  • Campaign learning may begin improving if leads are consistently moving through meaningful pipeline stages
  • Better quality events generally produce better optimisation signals
2-6 weeks
  • Some businesses may begin seeing improvements in lead quality, cost per qualified lead, conversion rates, and campaign optimisation
  • Results vary depending on lead volume, ad spend, pipeline quality, consistency of CRM stage usage, and quality of customer data
Consistency matters

The more consistently your team uses meaningful pipeline stages, the more useful the optimisation signal becomes for Meta.

Low-volume accounts

Accounts with very low lead volume may take longer for Meta to learn effectively because there is less conversion feedback available.

Feature evolving

Meta CRM event support in LeadSavvy will continue evolving as Meta expands CRM event capabilities and as we learn which events deliver the best campaign optimisation results.

Troubleshooting

No events appearing

  • Confirm the dataset ID is correct
  • Confirm the access token is correct
  • Make sure leads are moving through pipeline stages
  • Confirm CAPI settings were saved in LeadSavvy
  • Allow up to 24 hours for new CRM events to begin appearing in Meta Events Manager

Access token not working

  • The full endpoint URL was copied instead of the token only
  • There are accidental spaces before or after the token
  • The token was regenerated or expired

Events showing but not matching

  • Meta event matching depends on email addresses, phone numbers, Meta lead IDs, and other available customer data
  • Higher quality lead data improves event matching rates

Privacy and security

LeadSavvy sends CRM conversion data securely using Meta's official Conversions API. Personal identifier information used for event matching, such as email addresses and phone numbers, is hashed before it is sent. Only the data required for event matching and campaign optimisation is shared with Meta.

After setup, Meta can learn:

  • which leads become qualified
  • which leads progress through your pipeline
  • which leads become real opportunities
  • which leads become customers