Related: Meta pixel credentials, TikTok Events API, event deduplication, Pinterest Conversions API setup, and the Pinterest Conversions API complete guide.
What are Pinterest Conversions API events?
Pinterest calls the account value an ad account ID. It is not the same as a profile name, Pin ID, campaign ID, or Tag ID.
Where do you find the ad account ID and token?
- Open Pinterest Ads Manager.
- Select Ad Account Overview > Conversions > Conversions API > Set up API.
- Choose Conversion access token and generate a new token.
- Copy the token and the displayed ad account ID, then store the token as a secret.
Use an OAuth token only when you also need other Pinterest API endpoints and have the correct scopes. Do not use an unrelated personal account token.
Which Pinterest event should you choose?
| Business action | Typical Pinterest event | Useful context |
|---|---|---|
| Product or category viewed | view_category or page_visit | Product or page identity when relevant |
| Item added | add_to_cart | Product and quantity when relevant |
| Checkout completed | checkout | Order ID, value, and currency when relevant |
| Email sign-up | signup or the supported equivalent | Only after registration succeeds |
Pinterest rejects unsupported event names. Use documented API events such as view_category, page_visit, or checkout instead of guessing names from other platforms.
How do you run a Pinterest test?
- Enter the Pinterest ad account ID and conversion token.
- Select one supported event.
- Use test mode in Pixel Activator if it is available.
- Inspect Campaign manager > Conversions > Test events.
- Correct an event-name or parameter warning before sending production traffic.
Pinterest's documentation says a test batch processes only its first twenty events. A single first test avoids the limit altogether.
How does Pinterest deduplication work?
An order number can be the shared event ID when every order has a distinct number. For events without an order, generate a unique ID and send it unchanged through the browser and server paths. See event deduplication for the underlying discipline.
What data quality checks matter?
Pinterest also recommends appropriate matching identifiers and event-specific data. Include only data that is accurate and permitted by your privacy process.
Common Pinterest CAPI mistakes
| Mistake | Effect | Fix |
|---|---|---|
| Campaign ID used as destination | Event cannot reach the intended account | Copy the ad account ID shown with the conversion token |
| Unsupported event name | Pinterest returns an event-name error | Select a documented supported name |
| Static purchase ID | Distinct orders can collapse together | Use the actual unique order ID |
| Different Tag and CAPI IDs | One action can count twice | Send identical event ID and event name |
What is the launch checklist?
- Correct Pinterest ad account ID.
- Conversion token stored only as a secret.
- Supported event name mapped to a completed business action.
- A sandbox event is visible in Ads Manager when test mode is available; production delivery and attribution require separate checks.
- Unique event ID on every action and shared ID for duplicate sources.
Pinterest test event not appearing?
Need help with test mode or a rejected event? Send the error text or a screenshot with personal data and secrets removed. The first consultation is free.
Do not send passwords or API tokens.
Sources
Sources
Test Pinterest conversion events