Skip to content
adscapi

Pinterest CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and Pinterest is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://api.pinterest.com/v5/ad_accounts/{PINTEREST_AD_ACCOUNT_ID}/events
Headers
Authorization: Bearer {PINTEREST_CAPI_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "data": [
    {
      "event_name": "checkout",
      "action_source": "web",
      "event_time": 1739452800,
      "user_data": {
        "em": [
          "<sha256(normalized-email)>"
        ],
        "ph": [
          "<sha256(e164-phone)>"
        ]
      },
      "custom_data": {
        "value": 49.99,
        "currency": "USD",
        "order_id": "order_1001"
      },
      "event_id": "order_1001"
    }
  ]
}

Verified against the library dispatcher (src/dispatchers/pinterest.ts). See the Pinterest setup guide for where to get each secret.

Required secrets

PINTEREST_AD_ACCOUNT_IDPINTEREST_CAPI_TOKEN

Pinterest activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventPinterest receives
page_viewpage_visit
leadlead
signup_startsignup_start (custom event passthrough)
signupsignup
checkout_createdinitiate_checkout
purchasecheckout
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • A canonical purchase maps to event_name checkout — Pinterest's purchase-complete event.
  • em/ph arrays in user_data send only with adUserData consent; no IP or click id is sent.
  • Unmapped canonical events pass through as free-form custom names (capped at 15 custom types per advertiser).

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track Pinterest conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.