# Reddit Destination v3 Migration Guide


This guide walks you through migrating your Reddit destination integration from API v2 to API v3. 

{{< success >}}
The Reddit API v3 introduces updated event mapping and new capabilities while maintaining compatibility with your existing setup.
{{< /success >}}

## API v3 overview

The new Reddit API v3 introduces the following changes:

- Support for `test_id` in event properties for testing events in the Reddit dashboard
- The deprecated `properties.optOut` is replaced with `properties.modes` for data processing options

{{< info >}}
**API v2 is deprecated but not sunset yet.**.

RudderStack recommends migrating to API v3 to take advantage of the latest features and ensure continued support.
{{< /info >}}

### New features

The new Reddit API v3 supports the `test_id` property in event properties, which you can use to test events on the Reddit dashboard without affecting your production data.

Example event with `test_id`:

```json
{
  "type": "track",
  "event": "Order Completed",
  "userId": "test_user",
  "timestamp": "2025-01-22T13:00:00Z",
  "properties": {
    "test_id": "test_campaign_001",
    "revenue": 99.99,
    "currency": "USD"
  }
}
```

## Migration steps

Follow these steps to migrate your Reddit destination integration from API v2 to API v3:

### Update API version in dashboard

1. In your [RudderStack dashboard](https://app.rudderstack.com/), navigate to your Reddit destination.
2. Go to the **Configuration** tab in the destination page.
3. Under **Connection Settings**, go to the [**API Version**]({{< ref "destinations/streaming-destinations/reddit/_index.md#connection-settings" >}}) dropdown and select **v3**.
4. Save your changes.

### Update event properties

- Review and use the event and [property mappings]({{< ref "destinations/streaming-destinations/reddit/_index.md#supported-mappings" >}}) for API v3, as listed in the Reddit destination documentation.
- If you are currently using the `optOut` property in your event properties, update your events to use the new `modes` property with the value `["LDU"]` instead.

{{< info >}}
The `properties.optOut` property is deprecated in v3.
{{< /info >}}

{{< tabs tabTotal="2" >}}
{{% tab tabName="Before (API v2)" %}}
```json
{
  "type": "track",
  "event": "Order Completed",
  "userId": "test_user",
  "timestamp": "2025-01-22T13:00:00Z",
  "properties": {
    "optOut": "true",
    "revenue": 99.99,
    "currency": "USD"
  }
}
```
{{% /tab %}}
{{% tab tabName="After (API v3)" %}}
```json
{
  "type": "track",
  "event": "Order Completed",
  "userId": "test_user",
  "timestamp": "2025-01-22T13:00:00Z",
  "properties": {
    "modes": ["LDU"],
    "revenue": 99.99,
    "currency": "USD"
  }
}
```
{{% /tab %}}
{{< /tabs >}}

## Verify your migration

After migrating to API v3, send some events to verify that they are being processed correctly in the Reddit dashboard. If you are including the `test_id` property in your events, verify that test events appear separately.

## See more

- [Reddit Destination Setup Guide]({{< ref "destinations/streaming-destinations/reddit/_index.md" >}})
- [Reddit Conversions API documentation](https://business.reddithelp.com/s/article/Conversions-API)