Conversions API Gateway: Setup Guide

Updated: Jan 23, 2026

Use the following steps to set up the Conversions API Gateway.

Please ensure you have reviewed and completed the prerequisites for the Conversions API Gateway before you go through this setup guide.

Step 1: Get Started and Begin Deployment

To begin the setup process, navigate to the Settings tab within Meta Events Manager. Under “Set up with Conversions API Gateway”, click on Get started.

Events Manager Settings tab showing the Conversions API section with Conversions API Gateway (Recommended) selected and a Get started button

Review the prerequisites for the Conversions API Gateway and then select Next.

Set up your Conversions API Gateway dialog on the Get Started step, listing prerequisite accounts: Meta Business Account, Cloud infrastructure, and DNS provider

Select Preferences

Choose the settings you’d like to enable and then click Continue.

Enhance events can help to improve conversion attribution and maximize the performance benefits of events you currently share with Meta.

Conversions API Gateway health monitoring enables Meta to more effectively troubleshoot potential problems.

Select preferences step with Yes/No toggles for Enhance events with advanced matching data and Enable Conversions API Gateway health monitoring

Choose your desired cloud setup from the available options.

Select a cloud setup for AWS comparing ECS Express (from 40 dollars/month) and Elastic Kubernetes Service (from 300 dollars/month), both supporting up to 5,000 domains

Next, under Select your hosting region, choose your desired region. You can only set up the Conversions API Gateway in one region.

Click Next to open up Amazon Web Services (AWS) or click Copy URL to send to your organization’s AWS account administrator.

Deploy to AWS step with a Select cloud hosting region dropdown, Continue to AWS and Copy URL buttons, and numbered setup instructions

Step 2: Configure AWS and Install

A quick creation flow for the Conversions API Gateway stack will open.

AWS CloudFormation Quick create stack page with pre-populated template URL, stack name, and Conversions API Gateway Configuration fields including ProvisioningData

All fields will be pre-populated. Please don’t change the ProvisioningData field.

Click Create stack to begin the installation.

The creation process takes approximately 30 to 40 minutes, after which three outputs will be written to the “Outputs” tab for the new AWS instance. You will know it is done when the Status says: CREATE_COMPLETE in the Stack info Tab.

Once complete, go to the Outputs tab.

(Recommended) Create a custom domain to help data routing, see step 4 below.

Take note of the CapigSetupURL, which you will need to provision the Conversions API Gateway UI.

AWS CloudFormation stack Outputs tab listing three outputs: BastionHost, CapigSetupURL, and InstallationLogLocation with their values

Step 3: Verify Data Collection

To access the Conversions API Gateway Admin UI, use the CapigSetupURL within the Outputs tab (reference step 2). The CapigSetupURL can also be found within Events Manager.

You will be asked to create an admin account at the first login to the Admin UI

Select Log in after creating an admin account

You will see the Conversions API Gateway Admin UI site.

When you first view the site, the server and browser data may be at 0. This information should take 5 minutes to 2 hours to populate.

To check if the data is being collected, you can go to your website and refresh the page.

If events do not populate after 2 hours, please contact Meta.

You should now see Conversions API Gateway under your pixel settings.

(Recommended) Step 4: Add Custom Domain

Set up a custom domain within the Conversions API Gateway Admin UI. A custom domain is recommended as it may help optimize data routing and may reduce costs.

Note: You will need access to your DNS provider to add a custom domain

Log into the Conversions API Gateway Admin UI.

Navigate to Domain management on the left sidebar under Settings.

Choose between DNS provider AWS Certificate Manager (ACM) or Cloudflare.

Conversions API Gateway Admin UI Domain management page offering custom domain providers AWS Certificate Manager and Cloudflare, each with a Select provider button

1. AWS Certificate Manager

Please follow the ACM Setup instructions to finish setup.

2. Cloudflare

Please follow the Cloudflare Setup Instructions to finish setup.

Troubleshooting Setup Issues

Use these steps to troubleshoot issues when you set up the Conversions API Gateway. For general troubleshooting, see Conversions API Gateway - Troubleshooting Errors and Warnings.

Browser Autocomplete Interferes With Setup

If you can’t install the Conversions API Gateway because of expired provisioning data, even though you launched the installation from Events Manager, the browser autocomplete feature might be automatically populating previously used information.

Diagnostics

Launch installation from Events Manager and save the provisioning data for later examination.

Click Copy URL and save the copied URL to any text editor such as Notepad.

Click Begin deployment to launch the AWS creation page.

On the AWS creation page, find ProvisioningData and verify that the entry matches the URL that you copied previously. If they don’t match, autocomplete is on and you must turn it off.

Resolution

For FireFox browsers, use the following steps:

Click the Firefox menu icon (three bars at the top right of the screen).

Click on Settings.

Select the Privacy & Security settings.

Scroll to History and choose Use custom settings for history.

Unselect Remember search and form history.

Your changes are saved automatically.

For Chrome browsers, use the following steps:

Click the Chrome menu icon (three dots at the top right of screen).

Click on Settings.

Select the Autofill settings.

Expand the appropriate area.

Toggle the autofill setting off.

Your changes are saved automatically.

Additional Configurations

Events Manager allows you to add new connections, configure additional domains and add new Pixels to your existing Conversions API Gateway connection. To define these, please follow the below steps:

Click on Partner Integrations, which appears on left side of page:

Events Manager left navigation menu with options Connect Data Sources, Task Center, Data sources, Custom Conversions, and Partner Integrations highlighted

Select Conversions API Gateway to open the Conversions API Gateway.

Partner Integrations page with gateway searched, showing a Conversions API Gateway tile under Data Connection Platforms

In this screen you can view:

Website events

Events are website actions that are set up on your Conversions API Gateway site and are separately being sent to Meta using the Meta Pixel⁠.

Website domains

Websites your Conversions API Gateway is configured to connect with through the Pixel.

Click on the Settings and select the action you would like to take.

Conversions API Gateway settings dialog with a Launch button for Website events and links to add another connection or add a Pixel to an existing connection

Adding Another Conversions API Gateway Connection

This allows you to set up a new Conversions API Gateway instance with another Meta Pixel. Below shows the first step in the dialog, similar to the one from the Meta Pixel settings page. Next, you will be asked to select a Meta Pixel for the installation of your new Conversions API Gateway connection.

Setup your Conversions API Gateway dialog on the Get Started step listing benefits (Speed, Cost, Low technical lift, Low maintenance costs) and required accounts

Adding Another Meta Pixel to an Existing Conversions API Gateway Connection

This option allows you to onboard another Meta Pixel on an existing Conversions API Gateway installation.

To begin the setup process, navigate to the Settings tab within Events Manager. Under the section “Existing Conversions API Gateways”, click the Connect button: