Jump to a popular page, or start typing.

    BLOG / how-to

    Reddit Conversions API: How It Works and How to Set It Up

    The Reddit Conversions API sends conversion events to Reddit server-side, past pixel loss. How it works, how to set it up, verify it, and where it stops.

    Key takeaways

    • The Reddit Conversions API sends conversion events from your server to Reddit, so measurement no longer depends only on the browser pixel.
    • It works alongside the Reddit Pixel, and the two are deduplicated with a shared conversion ID so an event is not counted twice.
    • Reddit ads under-report conversions when the pixel is blocked; server-side events recover the ones the browser drops.
    • User identifiers such as email and phone are hashed with SHA-256 before they are sent, so Reddit receives an irreversible string, never readable personal data.
    • Phone numbers are normalised to the E.164 format, capped at 15 digits, before hashing so the value matches Reddit's copy.
    • Better-matched conversions give Reddit optimisation more signal, so campaigns bid on a fuller picture of what happened.
    • It measures what your systems record; it cannot recover a conversion your server never logged, and it does not fix a weak ad or landing page.

    What is the Reddit Conversions API?

    The Reddit Conversions API is Reddit’s server-side conversion connection. A Reddit Pixel fires in the browser, so anything that blocks the browser, an ad blocker, a cleared cookie, a privacy setting, also blocks the measurement. The Reddit Conversions API sends the same conversion events from your server instead, over a direct server-to-server connection, so an event reaches Reddit even when the pixel does not. Reddit’s developer documentation describes it as a way to send conversion events server-side, and it is Reddit’s version of the server-side conversion APIs the other major ad platforms run.

    Each event carries hashed user data so Reddit can match it to a person who engaged with an ad. Identifiers such as email and phone are hashed with SHA-256, which the NIST Secure Hash Standard defines as producing an irreversible 256-bit value written as 64 hexadecimal characters. Reddit receives the hash, matches it against its own hashed records, and never sees the raw value.

    How does the Reddit Conversions API work?

    The Reddit Conversions API works by moving the conversion out of the browser and into a server request. The flow runs in order:

    1. A person sees or clicks a Reddit ad, and Reddit records that engagement.
    2. The person completes an action on your site or app, such as a purchase.
    3. Your server builds a conversion event with the event name, a timestamp, a conversion ID, and the user’s SHA-256 hashed identifiers.
    4. Your server posts the event to the Reddit Conversions API.
    5. Reddit matches the hashed identifiers to the engagement, attributes the conversion, and feeds it into optimisation.

    The conversion ID is what keeps the pixel and the API from double counting. When both send the same event, Reddit sees the shared ID and keeps one. Sending server-side is what lets a conversion be reported when the pixel is blocked; without it, that conversion is missing.

    Why do Reddit ads under-report conversions?

    Reddit ads under-report conversions when the browser pixel cannot fire or cannot be matched. The pixel depends on the browser, so an ad blocker, a privacy setting, a cleared cookie, or a conversion that happens on a different device all break the measurement, and the conversion goes uncounted. The result is that a Reddit campaign can drive more sales than the pixel shows, which makes it look less effective than it is and starves optimisation of signal. The Reddit Conversions API addresses the cause: it sends the conversion from your server, where the browser cannot block it, and matches it with hashed first-party data. Under-reporting shrinks to the conversions your own systems never record, rather than everything the browser dropped.

    Reddit Pixel and Conversions API, side by side

    The Reddit Pixel and the Reddit Conversions API are not alternatives. They cover different failure modes, and running both is the recommended setup. The table sets out what each one sees.

    MethodWhere it runsWhat it missesWhen it matters
    Reddit PixelIn the browser, on the pageBlocked pixels, ad blockers, cross-deviceReal-time, low-effort baseline coverage
    Conversions APIOn your serverConversions your systems never recordRecovering events the browser drops
    Both, deduplicatedBrowser and server, one conversion IDLittle, if the conversion ID is sharedThe recommended production setup

    What user data does the Reddit Conversions API match on?

    The Reddit Conversions API matches on the user data you send with each event, and the more complete it is, the more conversions Reddit can attribute. The common fields are:

    • A hashed email address, lowercased and trimmed before hashing.
    • A hashed phone number, normalised to E.164 before hashing.
    • Click and device identifiers Reddit can read, such as the Reddit click ID where present.
    • Event context, including the event name, the value and currency for a purchase, and the conversion ID used for deduplication.

    Normalisation before hashing is the step that most often decides whether a match lands. A value hashed in the wrong case or format produces a different string and never matches, so the field looks present while contributing nothing.

    How do you set up and verify the Reddit Conversions API?

    Setting up the Reddit Conversions API means giving your server a way to send events and confirming they arrive. The steps:

    1. Confirm the Reddit Pixel is live, since the API runs alongside it.
    2. Generate a conversion access token in the Reddit Ads interface for the account that owns the pixel.
    3. Decide where events originate: your server, a warehouse, or a managed connection such as Datahash.
    4. Map the fields to hash, and apply SHA-256 to email and phone after normalising them.
    5. Send a shared conversion ID from both the pixel and the API so Reddit can deduplicate.
    6. Send test events, confirm they appear in the Reddit Events Manager, then move to live traffic.

    Datahash documents sending server-side events to the Reddit Conversions API, with prebuilt paths for forwarding GA4 events to Reddit and for sending Shopify events to Reddit. Verifying events in the Reddit Events Manager after go-live is what confirms the connection is matching, not just active.

    What are the limits of the Reddit Conversions API?

    The Reddit Conversions API only measures what your systems record. If a conversion happens but your server never logs it, Reddit never learns about it, so the quality of your own event data sets the ceiling. Matching depends on the identifiers you send, so a missing or mistyped email or phone cannot be matched, and a value hashed before it is normalised will not match either. It improves measurement and the optimisation that runs on it. It does not make a weak ad perform or fix a landing page that does not convert. And it depends on consent behind the user data you send. It reports signal that already exists. It does not create demand.

    What Datahash does about this

    Datahash runs the Reddit Conversions API as a server-side destination, so events reach Reddit from your infrastructure rather than depending on the browser pixel. It handles the SHA-256 hashing and the normalisation of email and phone, sends a shared conversion ID so the pixel and the API deduplicate, and forwards the events with the fields that lift match rates. The same first-party data layer that feeds Reddit also feeds Meta, Google, Pinterest, Snap and other destinations, so one pipeline serves them all rather than a separate integration per platform. Match and delivery are visible per event, so you can see what arrived rather than assume it did.

    FAQ

    Frequently asked questions

    Is the Reddit Conversions API free?

    Reddit does not charge a separate fee to use the Conversions API; it is part of Reddit's conversion measurement. The cost is the engineering to build and maintain the connection, or the fee of a managed provider that runs it for you. The API call itself is not a metered product you buy, though you still pay for the ads.

    Is Reddit's API free?

    Reddit's advertising APIs, including the Conversions API, are available to advertisers without a licence fee from Reddit for measurement use. You still pay for whatever sends the data, whether that is your own engineering time or a third-party connector. Reddit's separate data and content APIs have their own terms and pricing, so check the specific API you mean.

    Is the Reddit Conversions API worth it?

    If you advertise on Reddit and you lose conversions to blocked pixels, yes. Server-side events report actions the pixel misses, and the better-matched data helps Reddit optimise delivery. The return depends on how much measurement you were losing, so it matters most for advertisers with meaningful Reddit spend and real conversion volume.

    PUT IT TO WORK

    Reading is good. A live setup is better.