Skip to main content
Pinterest Conversion API By using ClickFlare’s Conversion API for Pinterest Ads, you can report conversion events from ClickFlare back to Pinterest through Pinterest’s Conversions API (CAPI). This works similarly to server-to-server postbacks, but is simpler to maintain and provides more reliable attribution.

​
Why should I use the Conversion API for Pinterest Ads?

Due to increasing browser restrictions and privacy frameworks (GDPR, ITP, ad blockers, etc.), traditional client-side tracking (Pinterest tag only) can miss a significant portion of conversions. Pinterest’s Conversions API helps you overcome these limitations by sending events directly from ClickFlare’s servers to Pinterest, ensuring that the conversions tracked in ClickFlare are also reflected in Pinterest Ads reporting and optimization With the Pinterest CAPI integration, you can:
  • Improve conversion accuracy and reduce data loss
  • Give Pinterest better data to optimize delivery and bidding
  • Maintain attribution even if cookies or browser tracking fail

​
What you’ll need for the integration

  • An active Pinterest Business / Ads account
  • An active ClickFlare account
  • Your Pinterest Ad Account ID
  • Your Pinterest Conversion Access Token
Pinterest Ad Account ID, and the Conversions access token are all available inside Pinterest Ads Manager under Conversions

​
Where to Find Pinterest Conversion API Information

​
Ad Account ID & Conversion Access Token

  1. Log in to your Pinterest business account
  2. Click the hamburger menu (☰) in the top-left corner
  3. Under Manage business, click **Conversions Under Manage business, click Conversions**
  4. In the left navigation, open Set Up API / Conversion Access Token
  5. On this screen, you’ll see:
    • Your Ad Account ID
    • A Generate new token button for the Conversions API
  6. Click Generate new token, then copy and store it securely
  7. You will use both the Ad Account ID and Conversion Token in your ClickFlare integration
You will use both the Ad Account ID and Conversion Token in your ClickFlare integration
⚠️ Treat your Conversion Access Token like a password — do not share it publicly.

​
Integrating Pinterest Conversion API in ClickFlare

Follow the steps below to add your Pinterest CAPI integration in ClickFlare:
  1. In ClickFlare, open the left-side menu and go to Integrations → Conversion API Integrations
  2. Click Add Integration
  3. From the list of available integrations, select Pinterest
From the list of available integrations, select Pinterest

​
Step 1 — Add a new Pinterest CAPI configuration

In the Pinterest integration setup window:
  1. In the Pinterest integration screen, click Add a new Pixel.
  2. Fill in the following details:
    • Pixel Name: choose a recognizable name.
    • Ad Account ID: paste your Pinterest Ad Account ID
    • Access Token: paste the Conversions API token you generated under Set Up API
  3. Click Save.
Pinterest Conversion API (2)

​
Step 2 — Map ClickFlare Events to Pinterest Events

Next, specify which ClickFlare conversion events should be sent to Pinterest and how they map to Pinterest’s standard event names. Common Pinterest events include:
  • Checkout – completed purchase or transaction
  • Add To Cart – item added to cart
  • Page Visit / View Content – key landing/product page views
  • Lead – lead or signup intent
  • Signup – registration
  • Search – on-site search
  • View Category – category views
  • Watch Video – video engagement
  • Custom – any custom funnel action
Make sure that:
  • Only relevant ClickFlare events are mapped
Only relevant ClickFlare events are mapped 👉 Learn how to create custom events in ClickFlare

​
Step 3 — Configure Event Data and Additional Parameters

ClickFlare automatically includes required parameters in the Pinterest CAPI payload, such as:
  • Pinterest Click ID (epik) when tracked properly
  • IP Address
  • User Agent
  • Event time (timestamp)
  • Value & Currency (for purchase-related events)
  • Country / Region (where available)
You can optionally enrich events with additional match keys, e.g.:
  • Hashed Email
  • Hashed Phone
  • Other customer identifiers
ClickFlare will hash all sensitive data before sending it to Pinterest. ClickFlare will hash all sensitive data before sending it to Pinterest
Note: Some fields are required for proper attribution and cannot be removed. If you use the Pinterest Traffic Source template, ClickFlare automatically appends required parameters (including the Pinterest click ID) to your campaign URLs.

​
Step 4 — Save and Verify the Integration

After mapping events and configuring data:
  1. Click Save
  2. Trigger a test conversion in your funnel
  3. Go to Pinterest Ads Manager → Conversions → Event history/testing
  4. Confirm the event appears with Source = API / Conversions API
If the event shows — integration is active ✔️

​
Troubleshooting

FREQUENTLY ASKED QUESTIONS Got questions? Find the answers below:
Q1: Do I need the Pinterest Tag script installed?
A1: No, CAPI can work alone. However, Pinterest recommends using Tag + CAPI together for the best deduplication and attribution accuracy.
Q2: Which events should I send?
A2: Typically:
  • Checkout / Purchase
  • AddToCart
  • Lead / Signup
  • ViewContent / PageVisit / ViewCategory
Pinterest supports a defined set of event names — always map to a valid event type.
Q3: Where do I find the credentials again?
A3: Ad Account ID & Conversion Token → Conversions → Set Up API / Conversion Access Token
Q4: Do I need to manually add Pinterest click parameters to URLs?
A4: No, ClickFlare automatically includes them when using the Pinterest Traffic Source template.