To help you get started with your integration of the Conversions API, use the information on this page to understand the prerequisites needed to use the API and learn how to create an access token.
If your business has a firewall for outbound requests, see Crawler IPs and User Agents to get Facebook's IP addresses. Be aware that the list of addresses changes often.
Website events shared using the Conversions API require the following data parameters:
event_source_url, while non-web events require only
action_source. These parameters contribute to improving the quality of events used for ad delivery and may improve campaign performance.
Register for the webinar: ‘How to Use Facebook’s Conversions API: A Developer's Guide’ on Wednesday, June 16th. Facebook experts will guide you step-by-step through implementing the Conversions API and best practices. A “Conversions API Direct Integration Playbook” will be sent to registered participants following the webinar.
Before implementing the Conversions API, make sure you have the Facebook pixel correctly implemented in your website. We recommend that you use the same pixel for your browser and server events.
You also need a Business Manager to use the API. Business Manager helps advertisers integrate Facebook marketing efforts across their business and with external partners. If you don't have a Business Manager yet, see the Help Center article on how to Create a Business Manager.
To use the Conversions API, you need an access token. There are two ways of getting your access token:
To use the Conversions API, you need to generate an access token, which is passed as a parameter in each API call. Inside Events Manager, follow these steps:
The Generate access token link is only visible to users with developer privileges for the business. The link is hidden from other users.
Once you have your token, click on the Manage Integrations button in the Overview tab in Events Manager. In the pop-up screen, click the Manage button next to Conversions API. This will automatically create a Conversions API app and Conversions API system user for you. There is no need to go through App Review or request any permissions.
Your app does not need to go through App Review. You do not need to request any permissions.
If you are a third-party partner offering Conversions API functionalities for advertisers:
Learn more about offering Conversions API as a Platform.