Pinterest Conversions API: Server-Side Tracking Setup [2025–2026]

Pinterest Server-Side Tracking vs the Pinterest Tag

The Pinterest tag is a JavaScript snippet that runs in the browser — it fires on page views, add-to-cart events, and checkouts client-side. Pinterest server-side tracking (CAPI) sends the same events directly from your server to Pinterest, bypassing the browser entirely.

They are not the same thing and are not interchangeable — they are designed to run together. The tag handles real-time browser signals; CAPI captures the events the tag misses due to ad blockers, ITP, or consent refusals. Running both with deduplication is the correct setup.

Do You Need Conversions API?

CAPI is recommended (not required) for most advertisers. You should prioritize it if:

• Your site has significant EU/UK traffic (GDPR consent banners block many tag fires)
• You target audiences that commonly use ad blockers (design-conscious, affluent demographics)
• Your Pinterest-reported conversions seem significantly lower than actual orders
• You're spending $2,000+/month — at that spend level, the data quality improvement is material

For Shopify stores under $1,000/month spend, the Pinterest Shopify app is sufficient — it includes a basic server-side component. CAPI becomes more important as spend and EU traffic increase.

Method 1: Shopify App (Simplest)

The Pinterest Shopify app includes a server-side component that functions as a basic CAPI integration. If you're on Shopify, this is active automatically when you use the Pinterest app — no additional setup.

To verify it's active: Pinterest app settings → verify "Enhanced Conversions" is enabled. This sends hashed customer data (email, name) alongside events to improve match rates.

Method 2: Pinterest CAPI Direct Integration

For non-Shopify stores or custom CAPI setups, you send events directly to Pinterest's API endpoint.

Step 1 — Get your access token

1. Pinterest Ads Manager → Ads → Conversions → Conversion Access Token
2. Create a new token — store it securely (treat like a password)

Step 2 — Send events on order completion (server-side)

When an order is placed, your server sends a POST request to Pinterest's API:

POST https://api.pinterest.com/v5/ad_accounts/{ad_account_id}/events

{
  "data": [
    {
      "event_name": "checkout",
      "action_source": "website",
      "event_time": 1715000000,
      "event_id": "ORDER-12345",
      "event_source_url": "https://yourstore.com/thank-you",
      "user_data": {
        "em": ["HASHED_EMAIL"],
        "ph": ["HASHED_PHONE"],
        "client_ip_address": "1.2.3.4",
        "client_user_agent": "Mozilla/..."
      },
      "custom_data": {
        "currency": "USD",
        "value": "549.00",
        "order_id": "ORDER-12345",
        "contents": [
          {
            "id": "SKU-789",
            "item_price": "549.00",
            "quantity": 1
          }
        ]
      }
    }
  ]
}

Step 3 — Hash user data correctly

Pinterest requires PII (email, phone) to be hashed with SHA256 before sending. The email must be normalized first (lowercase, trimmed):

// Node.js example
const crypto = require('crypto');
const hashedEmail = crypto
  .createHash('sha256')
  .update(email.toLowerCase().trim())
  .digest('hex');

Deduplication — Critical

If both your browser tag and CAPI send the same checkout event, Pinterest counts it twice. Deduplication prevents this — use the same unique identifier in both:

• Browser tag: pintrk('track', 'checkout', { order_id: 'ORDER-12345' })
• CAPI: "event_id": "ORDER-12345"

Pinterest matches events with the same event_id and order_id, deduplicates them, and counts the conversion once. Without this, your ROAS numbers will appear inflated.

Method 3: Via Integration Platforms

Several integration tools simplify CAPI setup without direct API calls:

• Elevar: Popular for Shopify — handles both tag and CAPI with deduplication
• Littledata: Shopify-specific, robust server-side tracking
• Segment: If you're already using Segment, it has a Pinterest CAPI destination
• Triple Whale: Attribution platform that includes Pinterest CAPI

For most home decor Shopify brands, Elevar or Littledata are the most straightforward options and don't require custom development.

Verifying CAPI Is Working

1. Make a test purchase
2. Pinterest Ads Manager → Ads → Conversions → Events → checkout event → Recent Activity
3. Look for events with action_source = "website" (tag) and action_source = "server" (CAPI)
4. Both should appear for the same order_id — with one counted after deduplication

---