Skip to content
adscapi

Snapchat CAPI Payload Preview

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

Request

POST
Endpoint
https://tr.snapchat.com/v2/conversion
Headers
Authorization: Bearer {SNAP_CAPI_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "pixel_id": "{SNAP_PIXEL_ID}",
  "data": [
    {
      "event_name": "PURCHASE",
      "event_time": "2025-02-13T13:20:00.000Z",
      "action_source": "WEB",
      "user": {
        "hashed_email": "<sha256(normalized-email)>",
        "hashed_phone_number": "<sha256(e164-phone)>",
        "client_ip_address": "203.0.113.10"
      },
      "custom_data": {
        "value": 49.99,
        "currency": "USD"
      },
      "event_id": "order_1001"
    }
  ]
}

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

Required secrets

SNAP_PIXEL_IDSNAP_CAPI_TOKEN

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

Event-name mapping

Canonical eventSnapchat receives
page_viewPAGE_VIEW
leadSIGN_UP
signup_startsignup_start (custom event passthrough)
signupSIGN_UP
checkout_createdSTART_CHECKOUT
purchasePURCHASE
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • event_time is an ISO 8601 string, not a unix timestamp.
  • The pixel id goes in the JSON body; the token is a Bearer header.
  • hashed_email, hashed_phone_number, and client_ip_address send only with adUserData consent.
  • Canonical lead also maps to SIGN_UP — Snapchat's enum has no LEAD value.

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 Snapchat 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.