You’ll need a Pinterest Business account to access the Pinterest Conversions API.
Once you have your business account, you’ll need to generate an access token. An access token is a string of characters that verifies the requests are being made and sent back to the correct user’s account.
To generate an access token:
Log in to your Pinterest business accountClick Ads in the top menu and choose ConversionsSelect the Set up API page from the left-hand side navigationClick the Generate new token buttonCopy the new access token as well as your account ID and share it with your developer team. You’ll also want to share our developer docs which contain technical details.
The Set up API section on the Conversions tab of Ads Manager includes a step-by-step guide on how to set up CAPI directly or with a partner.
If you’re trying to access an account you don’t own, you’ll need to set up Business Access. The account owner can also generate and share a token. However, we do not recommend sharing tokens unless you or the account owner have a secure way to do so.
Important things to remember
Data redundancy:Pinterest’s Conversions API can stand alone or can be used with other solutions such as the Pinterest Tag or Mobile Measurement Partners. We recommend that you set up a dual integration – pass the same events through Conversions API that you do through your Tag or MMP. This dual approach will help you to maximise conversion visibility which can ultimately lead to more efficient campaign results.Deduplication:If you are planning to send events through the Pinterest Tag/mobile measurement partner and the Conversions API, then you should ensure that you are not double-counting by enabling parameters for deduplication. Read more about deduplication on our developer site.Omni-channel event sharing:You have the ability to pass web events, app events and offline events through the Conversions API. If your business sells through any of these channels, then we recommend you pass those events as well, so you can attribute media dollars to the conversions that happen there.Real-time event sharing:You should share events in as close to real time (less than <1 hour) as possible. Doing so will allow you to see the results that your campaigns are driving faster, and help ensure that your bids are staying competitive with current marketplace demand.Limited data processing:You can use our Limited Data Processing flag to comply with state privacy laws. Learn more about limited data processing.Offline conversions:If you want to track offline events, but don’t have the resources to support Conversions API, you can upload an offline events file into Ads Manager. We will use this file to attribute offline conversions to your campaigns.
There are no developer resources required for this option. Learn how to upload offline conversions.