Skip to content
adscapi

Reddit CAPI Payload Preview

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

Request

POST
Endpoint
https://ads-api.reddit.com/api/v3/pixels/{REDDIT_PIXEL_ID}/conversion_events
Headers
Authorization: Bearer {REDDIT_CAPI_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "events": [
    {
      "event_at": 1739452800000,
      "action_source": "WEBSITE",
      "type": {
        "tracking_type": "PURCHASE"
      },
      "metadata": {
        "conversion_id": "order_1001",
        "value": 49.99,
        "currency": "USD"
      },
      "user": {
        "email": "<sha256(normalized-email)>"
      },
      "click_id": "rdt_cid-example-123"
    }
  ]
}

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

Required secrets

REDDIT_CAPI_TOKENREDDIT_PIXEL_ID

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

Event-name mapping

Canonical eventReddit receives
page_viewPAGE_VISIT
leadLEAD
signup_startsignup_start (custom event passthrough)
signupSIGN_UP
checkout_createdADD_TO_CART
purchasePURCHASE
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • event_at is epoch milliseconds, not seconds.
  • Only a hashed email goes in user (no phone or IP); it sends only with adUserData consent.
  • The rdt_cid click id maps to the click_id field and sends without a consent check.
  • Unmapped canonical events would pass through raw as tracking_type and be rejected; the map's CUSTOM escape hatch is not used.

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