Send Pinterest Conversions API events with Pixel Activator
event_idRelated: Meta pixel credentials, TikTok Events API, and event deduplication.
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.
For one-off event verification, use the free Pixel Activator — it fires test signals in minutes without custom engineering. When you need automated conversion routing with deduplication across platforms, set up Most.
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.
- Test event visible in Ads Manager.
- Unique event ID on every action and shared ID for duplicate sources.
Sources
Sources
- Manual testing and validation: use Pixel Activator for free test event dispatch and parameter checks before campaign launch.
- Automated routing and delivery: connect Most for resilient server-side conversion delivery with deduplication, retry queues, and pre-built integrations.