--- "@context": https://schema.org "@type": TechArticle "@id": https://www.twilio.com/docs/segment/connections/destinations/catalog/actions-reddit-conversions-api#article headline: Reddit Conversions API description: Send conversion events from Segment server-side to the Reddit Conversions API for resilient measurement, targeting, and campaign optimization. url: https://www.twilio.com/docs/segment/connections/destinations/catalog/actions-reddit-conversions-api inLanguage: en dateModified: 2026-10-08T15:03:23.000Z author: "@type": Organization name: Twilio Developer Education Team publisher: "@type": Organization name: Twilio --- # Reddit Conversions API ## Destination Info * Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls. * Refer to it as **Reddit Conversions Api**, **Reddit Conversions API** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object) * This integration is **partner owned.** Please reach out to the partner's support for any issues. The [Reddit Conversions API](https://ads-api.reddit.com/docs/v2/#tag/Conversions-API) allows advertisers to send conversion events from Segment directly to Reddit, without needing website code. By building a sustainable server-side connection more resilient to signal loss, you can gain stronger campaign performance with improved measurement, targeting, and optimization. ## Benefits of Reddit Conversions API * **Clear mapping of data**: Actions-based destinations enable you to define the mapping between the data Segment receives from your source and the data Segment sends to Reddit. * **Prebuilt mappings**: Mappings for Reddit Standard Events, like Purchase and AddToCart, are prebuilt with the prescribed parameters and is available for customization. * **Streamlined stability and security**: Integrate and iterate without client-side limitations, like network connectivity or ad blocker issues. * **Privacy-focused**: Stay compliant with rapidly evolving requirements with automatic PII hashing and flexible controls that let you adapt what data you share. * **Maximum event measurement**: Capture more events with improved accuracy across different browsers, apps, and devices to get a unified view of your customer's journey from page view to purchase. * **Data normalization**: Data is normalized before hashing to ensure the hashed value matches across sources and is in line with [Reddit data requirements](https://business.reddithelp.com/helpcenter/s/article/advanced-matching-for-developers). This destination is maintained by Reddit. For any issues with the destination, [contact the Reddit support team](mailto:adsapi-partner-support@reddit.com). ## Getting started To connect the Reddit Conversions API destination, follow these steps: 1. From the Segment web app, click **Catalog**, then click **Destinations**. 2. Search for "Reddit Conversions API" in the Destinations Catalog, and select the destination. 3. Select the source that will send data to the Reddit Conversions API and follow the steps to name your destination. 4. On the Settings tab, enter in your [Reddit Conversion Token](https://business.reddithelp.com/helpcenter/s/article/conversion-access-token) and Pixel ID (You can find your pixel ID in the [Events Manager](https://ads.reddit.com/events-manager), and it should match the business account's pixel ID found in [Accounts](https://ads.reddit.com/accounts)) and click **Save**. 5. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/segment/connections/destinations/actions/#customize-mappings). ## Reddit Conversions API V3 (Beta) The Send Standard Event and Send Custom Event actions support Reddit Conversions API V3, which is currently in beta. V2 remains the default: existing mappings and the prebuilt mappings continue to send to V2, and nothing changes unless you opt a mapping in to V3. V3 is Reddit's latest Conversions API. It adds omnichannel attribution, so you can tell Reddit whether a conversion happened on your website, in your app, in a physical store, or somewhere else. For website conversions, V3 also sends the URL of the page where the event occurred, which Reddit uses to improve attribution. V3 also supports Reddit Event Testing, so you can check test events before you send production traffic. To send a mapping's events to V3: 1. Open the Send Standard Event or Send Custom Event mapping and set **API Version** to **V3 (Beta)**. 2. Set **Action Source** to the channel where the conversion occurred: Website, App, Other, or Offline (Physical Store). Action Source is required for V3. 3. Make sure **Conversion ID** is mapped. Conversion ID is required for V3, and it's mapped to the Segment `messageId` by default. 4. If Action Source is Website, check that **Event Source URL** is mapped. It defaults to `context.page.url`. 5. Save the mapping. To test V3 events before you send production traffic: 1. In Reddit's Events Manager, open Event Testing and copy your test ID. 2. On the destination's Settings tab, paste the ID into **Test ID** and click **Save**. Reddit routes V3 events to Event Testing instead of production while this setting is populated. 3. Send some test events, then confirm they appear in Reddit Event Testing. 4. Clear the **Test ID** setting when you're done, so that events go to production. > \[!NOTE] > > The Test ID setting only applies to V3. The existing Test Mode setting only applies to V2. ## Destination Settings | Field | Description | Required | Type | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | | Pixel ID | Unique identifier of an ad account. This can be found in the Reddit UI. | Yes | string | | Conversion Token | The conversion token for your Reddit account. This can be found by following the steps mentioned \[here]\(https://business.reddithelp.com/helpcenter/s/article/conversion-access-token). | Yes | password | | Test ID | A test ID from Reddit Event Testing. When set, events are routed to Event Testing for verification instead of production. Remove before sending production traffic. Only applies to Reddit Conversions API V3 (Beta). | No | string | | Test Mode | Indicates if events should be treated as test events by Reddit. Only applies to Reddit Conversions API V2. V3 (Beta) is the latest API version. To send test events on V3, set the Test ID setting instead. | No | boolean | ## Available Presets Reddit Conversions API has the following presets | Preset Name | Trigger | Default Action | | --------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------- | | Purchase | Event type = "track" and event = "Order Completed" | Send Standard Event | | Sign Up | Event type = "track" and event = "Signed Up" | Send Standard Event | | Lead | Event type = "track" and event = "Lead Generated" | Send Standard Event | | Add to Cart | Event type = "track" and event = "Product Added" | Send Standard Event | | Add to Wishlist | Event type = "track" and event = "Product Added to Wishlist" | Send Standard Event | | Reddit Browser Plugin | Event type = "track", Event type = "identify", Event type = "group", Event type = "page", Event type = "alias" | Reddit Browser Plugin | | Search | Event type = "track" and event = "Products Searched" | Send Standard Event | | View Content | Event type = "track" and event = "Product Viewed" | Send Standard Event | | Page Visit | Event type = "page" | Send Standard Event | ## Available Actions Build your own Mappings. Combine supported [triggers](/docs/segment/connections/destinations/actions/#components-of-a-destination-action) with the following Reddit Conversions API-supported actions: > \[!NOTE] > > Individual destination instances support a maximum of 5 mappings. * [Send Custom Event](#send-custom-event) * [Send Standard Event](#send-standard-event) * [Reddit Browser Plugin](#reddit-browser-plugin) ### Send Custom Event Send a Custom Conversion Event to Reddit Send Custom Event is a **Cloud** action. | Field | Description | Required | Type | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | | API Version | The version of the Reddit Conversions API to send this event to. "V3 (Beta)" requires Action Source to be set. | No | STRING | | Action Source | The source/channel where the conversion occurred, used for omnichannel attribution. Only applies to, and required for, Reddit Conversions API V3 (Beta). | No | STRING | | Event At | The RFC3339 timestamp when the conversion event occurred | Yes | DATETIME | | Custom Event Name | A custom event name that can be passed when tracking\_type is set to "Custom". All UTF-8 characters are accepted and custom\_event\_name must be at most 64 characters long. | Yes | STRING | | Event Source URL | The URL of the page where the event occurred. Reddit parses the domain for attribution. Include the click ID in the URL to improve match rates. Only applies to Reddit Conversions API V3 (Beta) when Action Source is Website. | No | STRING | | Click ID | The Reddit-generated id associated with a single ad click. | No | STRING | | Products | The products associated with the conversion event. | No | OBJECT | | User | The identifying user parameters associated with the conversion event. | No | OBJECT | | Data Processing Options | A structure of data processing options to specify the processing type for the event. | No | OBJECT | | Screen Dimensions | The dimensions of the user's screen. | No | OBJECT | | Event Metadata | The metadata associated with the conversion event. | No | OBJECT | | Conversion ID | The unique conversion ID that corresponds to a distinct conversion event. Use this for event deduplication. Required for Reddit Conversions API V3 (Beta). If not hashed, Segment will hash this value. | No | STRING | | Enable Batching? | When enabled, Segment will send events in batches. | No | BOOLEAN | ### Send Standard Event Send a Standard Conversion Event to Reddit Send Standard Event is a **Cloud** action. | Field | Description | Required | Type | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | | API Version | The version of the Reddit Conversions API to send this event to. "V3 (Beta)" requires Action Source to be set. | No | STRING | | Action Source | The source/channel where the conversion occurred, used for omnichannel attribution. Only applies to, and required for, Reddit Conversions API V3 (Beta). | No | STRING | | Event At | The RFC3339 timestamp when the conversion event occurred | Yes | DATETIME | | Tracking Type | One of Reddit CAPI's standard conversion event types. To send a Custom event to Reddit use the Custom Event Action instead. | Yes | STRING | | Event Source URL | The URL of the page where the event occurred. Reddit parses the domain for attribution. Include the click ID in the URL to improve match rates. Only applies to Reddit Conversions API V3 (Beta) when Action Source is Website. | No | STRING | | Click ID | The Reddit-generated id associated with a single ad click. | No | STRING | | Products | The products associated with the conversion event. | No | OBJECT | | User | The identifying user parameters associated with the conversion event. | No | OBJECT | | Data Processing Options | A structure of data processing options to specify the processing type for the event. | No | OBJECT | | Screen Dimensions | The dimensions of the user's screen. | No | OBJECT | | Event Metadata | The metadata associated with the conversion event. | No | OBJECT | | Conversion ID | The unique conversion ID that corresponds to a distinct conversion event. Use this for event deduplication. Required for Reddit Conversions API V3 (Beta). If not hashed, Segment will hash this value. | No | STRING | | Enable Batching? | When enabled, Segment will send events in batches. | No | BOOLEAN | ### Reddit Browser Plugin Enriches Segment payloads with data from the Reddit Pixel Reddit Browser Plugin is a **Web** action. The default Trigger is `type = "track" or type = "identify" or type = "page" or type = "group" or type = "alias"` This action does not have any fields. ## Attribution signal matching At least one attribution signal is required with each conversion event. Send as many signals as possible to improve attribution accuracy and performance. * **Recommended Signals**: * Reddit Click ID * Reddit UUID * IP Address * Email * User Agent * Screen Dimensions * **Additional Signals**: * Mobile Advertising ID * External ID ## PII Hashing Segment creates a SHA-256 hash of the following fields before sending to Reddit. If you hash the values before sending it to Segment, it must follow the hashing format described in the [Reddit Advanced Matching documentation](https://business.reddithelp.com/helpcenter/s/article/advanced-matching-for-developers) to properly match. * Email * Phone Number * Mobile Advertising ID * IP Address * External ID ### Pre-hashed values Reddit expects a SHA-256 hash written as 64 lowercase hexadecimal characters. Segment handles values you send as follows, whether the event goes to V2 or V3: * **Hexadecimal hashes**: a 64-character hexadecimal value is treated as already hashed and isn't hashed again. For Email, Phone Number, and Mobile Advertising ID, Segment also converts the hash to lowercase. * **Base64 hashes**: a Base64-encoded SHA-256 hash (44 characters, ending in `=`) is treated as already hashed. Segment converts it to hexadecimal format and sends it without hashing it again. This applies to Email, Phone Number, Mobile Advertising ID, and IP Address. Segment can't tell a Base64 hash from an identifier that happens to have the same format, so don't send an identifier in this format unless it's a hash. * **External ID**: Segment treats a Base64-looking External ID the same way as any regular string. It doesn't recognize it as a hash, so it hashes the value with SHA-256 and sends the result as a hexadecimal string. If you pre-hash External ID, send the hash in hexadecimal format. * **Whitespace**: Segment removes spaces before and after a value before checking whether it's hashed. ### Invalid emails Email must be a valid email address or a SHA-256 hash. If it's neither, Segment handles the event differently depending on the **API Version** of the mapping: * **V3 (Beta)**: the event fails with a validation error, and Segment sends the rest of the batch to Reddit. * **V2**: Segment removes the email and sends the event with the other identifiers you mapped, with no error. If you notice a drop in email matches, check that you've correctly mapped Email. ## Deduplication with the Reddit Pixel If you implement both the [Reddit Pixel](https://business.reddithelp.com/helpcenter/s/article/reddit-pixel) and [Conversions API (CAPI)](https://business.reddithelp.com/helpcenter/s/article/Conversions-API) and the same events are shared across both sources, deduplication is necessary to ensure those events aren't double-counted. The integration automatically pre-maps the Segment `messageId` to the Reddit Conversion ID. If you wish to change this, you can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there's less risk of incorrect integration, which can impact attribution accuracy. To ensure your events are deduplicated: * Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events. * Include the event in the Reddit Pixel and CAPI. * Ensure the conversion event name and conversion ID for its corresponding events match. For more information on deduplication, see the [Reddit Event Deduplication documentation](https://business.reddithelp.com/helpcenter/s/article/event-deduplication). ## Verify events in the Reddit Events Manager After you start sending events, you can navigate to the Reddit Events Manager to see if the events are being received in near real-time. For more information, see the [Reddit Events Manager documentation](https://business.reddithelp.com/helpcenter/s/article/Events-Manager). ## Reddit Browser Plugin The Reddit Browser Plugin enriches your Segment event data with Reddit advertising identifiers to improve conversion tracking and attribution for your Reddit ad campaigns. How it works: When visitors arrive at your site from Reddit ads, the plugin automatically captures the Reddit Click ID (`rdt_cid`) from URL parameters and retrieves the Reddit UUID from the Reddit Pixel cookie. These identifiers are stored locally in the browser and attached to all subsequent Segment events—including Track, Identify, Page, Group, and Alias calls. Data forwarding: The enriched event data is automatically sent to the Reddit Conversions API destination, ensuring your Reddit advertising campaigns have accurate attribution without requiring manual implementation. Setup: This plugin is automatically configured and enabled when you create a Reddit Conversions API destination that's connected to an [Analytics.js source](/docs/segment/connections/sources/catalog/libraries/website/javascript). ## Engage You can send computed traits and audiences generated using [Engage](/docs/segment/engage) to this destination as a **user property**. To learn more about Engage, schedule a [demo](https://segment.com/contact/demo). For user-property destinations, an [identify](/docs/segment/connections/spec/identify/) call is sent to the destination for each user being added and removed. The property name is the snake\_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property `order_completed_last_30days: true`. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to `false`. When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync. ## Settings Segment lets you change these destination settings from the Segment app without having to touch any code. | Field | Description | Required | Type | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | | Pixel ID | Unique identifier of an ad account. This can be found in the Reddit UI. | Yes | string | | Conversion Token | The conversion token for your Reddit account. This can be found by following the steps mentioned \[here]\(https://business.reddithelp.com/helpcenter/s/article/conversion-access-token). | Yes | password | | Test ID | A test ID from Reddit Event Testing. When set, events are routed to Event Testing for verification instead of production. Remove before sending production traffic. Only applies to Reddit Conversions API V3 (Beta). | No | string | | Test Mode | Indicates if events should be treated as test events by Reddit. Only applies to Reddit Conversions API V2. V3 (Beta) is the latest API version. To send test events on V3, set the Test ID setting instead. | No | boolean |