Skip to content
Marketing

How to send a Meta Conversion API action for Ad Manager?

In this article we will be talking about the process of creating a workflow for sending back Conversion API action to Meta and the newly added ad manager…

6 min read1,267 words6 explained images
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Why do I need to create a CAPI action workflow after creating an ad campaign and conversion dataset?
  2. Which workflow triggers can be used with Meta Conversion API action?
  3. How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?
  4. Lead Event + Stage Name = Purchase: Value and Currency
  5. Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action?

In this article we will be talking about the process of creating a workflow for sending back Conversion API action to Meta and the newly added ad manager radio button under Meta Conversion API action in workflows and what value does it add to the user.


TABLE OF CONTENTS


Why do I need to create a CAPI action workflow after creating an ad campaign and conversion dataset?

Creating and sending CAPI (Conversions API) events to Meta after setting up your ad and dataset is important for enhancing the accuracy, reliability, and effectiveness of your Meta advertising campaigns. Here’s why you need to use the CAPI in addition to the standard Meta dataset:

  • Improved Accuracy: CAPI sends data directly from your server, bypassing issues like browser restrictions, ad blockers, and cookie limitations, ensuring more reliable tracking of user actions.
  • Better Attribution: It tracks conversions across devices and platforms (including users who block cookies), providing more complete data for campaign optimisation therefore accurate reporting.
  • Fills Pixel Gaps: When pixel data is blocked or missed (e.g., due to slow load times or privacy settings), CAPI ensures those conversions are still recorded.
  • Enhanced Optimisation: More granular, server-side data helps Meta improve ad targeting and performance.
  • Privacy Compliance: CAPI is better suited for privacy regulations as it reduces reliance on client-side cookies.
  • Efficient Budget Spend: More accurate data allows Meta to optimise your ad spend and improve return on investment (ROI).

In summary, sending back CAPI events to Meta after creating your pixel is essential to improve the accuracy of your tracking, optimise your ads more effectively, and enhance attribution across devices and browsers. It fills in gaps left by browser-based pixel tracking and helps ensure that your ad campaigns are working as efficiently as possible, even with increasing privacy concerns and browser restrictions.


Which workflow triggers can be used with Meta Conversion API action?

Which workflow triggers can be used with Meta Conversion API action? (image 1 of 6) What this shows In summary, sending back CAPI events to Meta after creating your pixel is essential to improve the accuracy of your tracking, optimise… What this shows Illustrates the "Which workflow triggers can be used with Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot appears in the "Which workflow triggers can be used with Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". The text alongside this image reads: In summary, sending back CAPI events to Meta after creating your pixel is essential to improve the accuracy of your tracking, optimise your ads more effectively, and enhance attribution across devices and browsers. It fills in gaps left by browser-based pixel tracking and helps ensure that your ad…. Immediately after, the guide continues: In workflows, if your action is Meta Conversion API, the triggers which can be used depend on the Event Type that you will be using in the FB CAPI action. All the eligible triggers for both lead and funnel events are listed as under. Image 1 of 6 What this coversIn summary, sending back CAPI events to Meta after creating your pixel is essential to improve the accuracy of your tracking, optimise your ads more effectively, and enhance attribution across devices and browsers. It fills in gaps left by browser-based pixel tracking and helps ensure that your ad campaigns are working as efficiently as possible, even with increasing privacy concerns and browser restrictions. Next stepIn workflows, if your action is Meta Conversion API, the triggers which can be used depend on the Event Type that you will be using in the FB CAPI action. All the eligible triggers for both lead and funnel events are listed as under:
All 3 steps in this procedure
  1. For Funnel events in Meta conversion API action, you can use the following triggers; Form Submitted, Survey Submitted, Customer Booked Appointment, and Order Form Submission. (For an appointment, it will only work with "Customer Booked appointment," not with "appointment," as appointments are the general triggers and "Customer Booked appointment" is the trigger for the widget)
  2. For Lead events in Meta conversion API action, you can only use the trigger "Facebook Lead Form Submission" and "Pipeline Stage Change"(This will work if your contact is coming from a Facebook lead form).
  3. For Instagram DM events in Meta conversion API action, you can use any trigger that results in contact creation in the CRM.

In workflows, if your action is Meta Conversion API, the triggers which can be used depend on the Event Type that you will be using in the FB CAPI action. All the eligible triggers for both lead and funnel events are listed as under:

  1. For Funnel events in Meta conversion API action, you can use the following triggers; Form Submitted, Survey Submitted, Customer Booked Appointment, and Order Form Submission.
    (For an appointment, it will only work with "Customer Booked appointment," not with "appointment," as appointments are the general triggers and "Customer Booked appointment" is the trigger for the widget)
  2. For Lead events in Meta conversion API action, you can only use the trigger "Facebook Lead Form Submission" and "Pipeline Stage Change"(This will work if your contact is coming from a Facebook lead form).
  3. For Instagram DM events in Meta conversion API action, you can use any trigger that results in contact creation in the CRM.

How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?

During the creation of conversion API action under workflows, we see two connection type option:

  • Integrations
  • Ad Manager
How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action? (image 2 of 6) What this shows During the creation of conversion API action under workflows, we see two connection type option: What this shows Illustrates the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot appears in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". The text alongside this image reads: During the creation of conversion API action under workflows, we see two connection type option. This part of the guide covers 2 fields, listed below. Immediately after, the guide continues: Note: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles: Meta conversion leads walkthrough Setup a funnel…. Image 2 of 6 What to fill inDuring the creation of conversion API action under workflows, we see two connection type option:
Fields in this part of the guide IntegrationsAd Manager
Next stepNote: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles: Meta conversion leads walkthrough Setup a funnel event for Meta conversion API
All 2 steps in this procedure
  1. Integrations
  2. Ad Manager
How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action? (image 3 of 6) What this shows During the creation of conversion API action under workflows, we see two connection type option: What this shows Illustrates the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot appears in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". The text alongside this image reads: During the creation of conversion API action under workflows, we see two connection type option. This part of the guide covers 2 fields, listed below. Immediately after, the guide continues: Note: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles: Meta conversion leads walkthrough Setup a funnel…. Image 3 of 6 What to fill inDuring the creation of conversion API action under workflows, we see two connection type option:
Fields in this part of the guide IntegrationsAd Manager
Next stepNote: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles: Meta conversion leads walkthrough Setup a funnel event for Meta conversion API
All 2 steps in this procedure
  1. Integrations
  2. Ad Manager
Note: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles:
Meta conversion leads walkthrough 
Setup a funnel event for Meta conversion API

The addition of Ad Manager option as the connection type is mainly to ease the user flow and save the hassle of constant to and fro from Meta to workflows. Below are the enlisted points on what efforts are minimised with the addition of it.

  1. You can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM.
    Step 1 of 4: You can select the event type based on the campaign you want to send… What this shows Step 1 of 4: You can select the event type based on the campaign you want to send back CAPI to Meta. What this shows Shows what to fill in for step 1 of 4 in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot accompanies step 1 of 4 in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". At this point in the walkthrough you you can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM. This part of the guide covers 2 fields, listed below. The next step is to all the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID. Step 1 of 4Image 4 of 6 What to fill inYou can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM.
    Fields in this part of the guide IntegrationsAd Manager
    Next stepAll the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID.
    All 4 steps in this procedure
    1. You can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM. this image
    2. All the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID.
    3. There is no need to generate and then add the access token to CAPI action when under Ad Manager connection type, we take care of it to again help you with the to and fro.
    4. Stage name in a Lead Event refers to: It should accurately represent your Pipeline and Pipeline Stage name for better reporting. Select it using the tag icon at the end to add the custom value of the opportunity pipeline and stages.
  2. All the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID.
    Step 2 of 4: All the pixels that are part of Ad Manager will be pre-populated as… What this shows Step 2 of 4: All the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. What this shows Shows what to choose for step 2 of 4 in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot accompanies step 2 of 4 in the "How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". At this point in the walkthrough you all the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID. This part of the guide covers 2 fields, listed below. The next step is to there is no need to generate and then add the access token to CAPI action when under Ad Manager connection type, we take care of it to again help you with the to and fro. Step 2 of 4Image 5 of 6 What to chooseAll the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID.
    Fields in this part of the guide IntegrationsAd Manager
    Next stepThere is no need to generate and then add the access token to CAPI action when under Ad Manager connection type, we take care of it to again help you with the to and fro.
    All 4 steps in this procedure
    1. You can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM.
    2. All the pixels that are part of Ad Manager will be pre-populated as the dropdown items giving you an option to select one from it. This saves you from the hassle of going back to Meta and copy/paste the Pixel ID. this image
    3. There is no need to generate and then add the access token to CAPI action when under Ad Manager connection type, we take care of it to again help you with the to and fro.
    4. Stage name in a Lead Event refers to: It should accurately represent your Pipeline and Pipeline Stage name for better reporting. Select it using the tag icon at the end to add the custom value of the opportunity pipeline and stages.
  3. There is no need to generate and then add the access token to CAPI action when under Ad Manager connection type, we take care of it to again help you with the to and fro.
  4. Stage name in a Lead Event refers to: It should accurately represent your Pipeline and Pipeline Stage name for better reporting. Select it using the tag icon at the end to add the custom value of the opportunity pipeline and stages. 

Lead Event + Stage Name = Purchase: Value and Currency 

When you configure Meta Conversion API in a Workflow with:

Event Type: Lead Event  

Stage Name: Purchase  

GHL Customer Care shows two additional fields:

  • Value: Supports a static value or a custom field
  • Currency: Dropdown (defaults to USD), using the same currency list as Funnel Events

These fields are required only when Stage Name is Purchase.

Backend Behavior

- If Value and Currency are provided, GHL Customer Care sends them in the CAPI payload.

- If Stage Name is not Purchase, GHL Customer Care ignores any Value/Currency present in the payload.


Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action?

Yes, it is possible to do so and we will be using the last possible pixel data to send this event. Basically, if the fbclid id is found, the data will be sent to conversion API. It can be best explained by the following examples:

Example 1: 

Contact created Facebook form submission, thus first attribution source will be Paid Social (Facebook).  If you use workflow with Facebook form submitted trigger, the contact will have fbclid and workflow will send data to conversion API (CAPI).

Additional Behaviour -

After sometime that contact got converted to opportunity with add/update opportunity trigger addition, you use opportunity status trigger in workflow to send the data to conversion api as contact from Facebook form submitted will pass fbclid.

Example 2: 

Contact created google ad, organic google search or direct traffic,, thus first attribution source will be Paid Search (Google) or Direct Traffic. If the contact after certain time interacted with Facebook form and they fill the form, the latest attribution will be Paid Social(Facebook) with contact having fbclid. Now, if the agency runs workflow with Facebook form submitted > Meta conversion API, it will send the data to conversion API with fbclid.

Additional Behaviour 

After sometime that contact got converted to opportunity with add/update opportunity trigger addition, you use opportunity status trigger in workflow to send the data to conversion api as contact from Facebook form submitted will pass fbclid.


Please Note:


Addition of Custom Values -

Similar to Google Ads, we are now allowing custom mapping for Facebook Ads conversion tracking parameters.

Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action? (image 6 of 6) What this shows Similar to Google Ads, we are now allowing custom mapping for Facebook Ads conversion tracking parameters. What this shows Illustrates the "Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". This screenshot appears in the "Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action?" section of "How to send a Meta Conversion API action for Ad Manager?". The text alongside this image reads: Similar to Google Ads, we are now allowing custom mapping for Facebook Ads conversion tracking parameters. Image 6 of 6 What this coversSimilar to Google Ads, we are now allowing custom mapping for Facebook Ads conversion tracking parameters.
Buttons and menus referenced Additional Behaviour -Additional BehaviourAddition of Custom Values -
How It Works:
By default, custom mapping is disabled.
Users can toggle it on to enable custom mapping.
When enabled, users can map:

1. FBCLID for funnel events.
2. Facebook Lead ID for lead events.
3. If custom mapping fields are provided, they will take priority over system defaults.
4. If left empty, the system will continue using its default internal values.

Frequently asked questions

Why do I need to create a CAPI action workflow after creating an ad campaign and conversion dataset?
Creating and sending CAPI (Conversions API) events to Meta after setting up your ad and dataset is important for enhancing the accuracy, reliability, and effectiveness of your Meta advertising campaigns. Here’s why you need to use the CAPI in addition to the standard Meta dataset: Improved Accuracy: CAPI sends data directly from your server, bypassing issues like browser restrictions, ad blockers, and cookie limitations, ensuring more reliable tracking of user actions. Better Attribution: It tracks conversions across devices and platforms (including users who block cookies), providing more complete data for campaign optimisation therefore accurate reporting. Fills Pixel Gaps: When pixel data is blocked or missed (e.g., due to slow load times or privacy settings), CAPI ensures those conversions are still recorded. Enhanced Optimisation: More granular, server-side data helps Meta improve…
Which workflow triggers can be used with Meta Conversion API action?
In workflows, if your action is Meta Conversion API, the triggers which can be used depend on the Event Type that you will be using in the FB CAPI action. All the eligible triggers for both lead and funnel events are listed as under: For Funnel events in Meta conversion API action, you can use the following triggers; Form Submitted, Survey Submitted, Customer Booked Appointment, and Order Form Submission. (For an appointment, it will only work with "Customer Booked appointment," not with "appointment," as appointments are the general triggers and "Customer Booked appointment" is the trigger for the widget) For Lead events in Meta conversion API action, you can only use the trigger "Facebook Lead Form Submission" and "Pipeline Stage Change"(This will work if your contact is coming from a Facebook lead form). For Instagram DM events in Meta conversion API action, you can use any trigger…
How is Ad Manager radio button different from Integrations radio button in the Meta Conversion API action?
During the creation of conversion API action under workflows, we see two connection type option: Integrations Ad Manager Note: All the information with respect to the Integration connection type and the details of what each field under it means can be understood in detail by following the below two articles: Meta conversion leads walkthrough Setup a funnel event for Meta conversion API The addition of Ad Manager option as the connection type is mainly to ease the user flow and save the hassle of constant to and fro from Meta to workflows. Below are the enlisted points on what efforts are minimised with the addition of it. You can select the event type based on the campaign you want to send back CAPI to Meta. If your campaign objective is 'Website traffic' send a funnel event and if it's 'Lead generation' then send a lead event and for Click to direct ads select Instagram DM. All the…
Can I use the offline events with trigger names like 'Call', 'opportunity change status', 'tag', etc. with Meta Conversion API action?
Yes, it is possible to do so and we will be using the last possible pixel data to send this event. Basically, if the fbclid id is found, the data will be sent to conversion API. It can be best explained by the following examples: Example 1: Contact created Facebook form submission, thus first attribution source will be Paid Social (Facebook). If you use workflow with Facebook form submitted trigger, the contact will have fbclid and workflow will send data to conversion API (CAPI). Additional Behaviour - After sometime that contact got converted to opportunity with add/update opportunity trigger addition, you use opportunity status trigger in workflow to send the data to conversion api as contact from Facebook form submitted will pass fbclid. Example 2: Contact created google ad, organic google search or direct traffic,, thus first attribution source will be Paid Search (Google) or…

Was this guide helpful?

Related guides