> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit Connector

> Deliver custom audiences to Reddit Ads for ad targeting

The Reddit Connector delivers audience data to Reddit Ads, enabling you to create Custom Audiences for targeting in Reddit ad campaigns.

## Overview

The connector pushes your audience data to Reddit as customer-list Custom Audiences. You can create a new audience, deliver into an existing one, or propagate opt-outs that remove users from every Reddit audience you deliver to.

## Requirements

### Account access

* A Reddit Ads account
* A Reddit account with access to the business and ad account where audiences will be created (the OAuth grant requires the `adsread` and `adsedit` scopes)

### Supported identifiers

Your data must include at least one of these identifier types, mapped to the corresponding Rosetta Stone attribute:

| Identifier Type               | Rosetta Stone Attribute                                                                                                   |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| SHA256 hashed email           | [`sha256_hashed_email`](https://app.narrative.io/platform/rosetta-stone/attributes/sha256_hashed_email)                   |
| Hashed email (SHA256)         | [`hashed_email`](https://app.narrative.io/platform/rosetta-stone/attributes/hashed_email) (type `sha256_email`)           |
| Email                         | [`raw_email`](https://app.narrative.io/platform/rosetta-stone/attributes/raw_email) (automatically normalized and hashed) |
| Apple IDFA                    | [`apple_idfa`](https://app.narrative.io/platform/rosetta-stone/attributes/apple_idfa)                                     |
| Android Advertising ID (GAID) | [`android_advertising_id`](https://app.narrative.io/platform/rosetta-stone/attributes/android_advertising_id)             |
| Narrative ID                  | [`narrative_id`](https://app.narrative.io/platform/rosetta-stone/attributes/narrative_id)                                 |

The connector also accepts the generic [`mobile_id_unique_identifier`](https://app.narrative.io/platform/rosetta-stone/attributes/mobile_id_unique_identifier) attribute when its `type` resolves to one of the identifiers above.

<Note>
  Hashed identifiers must use SHA256 — hashed emails with SHA-1 or MD5 hashes are skipped during delivery. See [Hashing PII for Upload](/guides/ingestion/hashing-pii) for formatting requirements.
</Note>

<Warning>
  Reddit customer lists do not accept phone numbers.
</Warning>

## Installation

<Steps>
  <Step title="Navigate to the connector">
    In Narrative, go to **Installed Apps** and select **Reddit Connector**.
  </Step>

  <Step title="Create a profile">
    Provide a **Profile name** and an optional description.
  </Step>

  <Step title="Authorize with Reddit">
    Open the authorization link while logged into the Reddit account that owns the ad account, and click **Allow**. The grant covers every business and ad account that Reddit account can reach.
  </Step>

  <Step title="Review ad accounts">
    Open the profile to view the ad accounts discovered for the authorized account. Refresh the list if new ad accounts have been added on the Reddit side.
  </Step>
</Steps>

## Delivering audiences

When connecting a dataset to the Reddit Connector, you choose how the audience is created:

### New audience

Creates a new customer-list Custom Audience in your Reddit ad account.

| Setting          | Description                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| Audience name    | Name for the Custom Audience created in Reddit (3–500 characters, pre-filled from the dataset name)         |
| Ad account       | The Reddit ad account the Custom Audience is created under                                                  |
| Deliver all data | Whether to include data already in the dataset, or only new data written after the connection is configured |

### Existing audience

Delivers into a Custom Audience that already exists in Reddit.

| Setting          | Description                                                                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Audience ID      | The ID of the existing Reddit Custom Audience (format `ca.xxxxxxxxx`). It must be a customer-list audience reachable with the profile's grant. |
| Deliver all data | Whether to include data already in the dataset, or only new data written after the connection is configured                                    |

### Opt-outs

Connect a dataset of opted-out users to the opt-out interface. Their identifiers are removed from every Reddit Custom Audience your account delivers to; the interface itself names no audience.

<Note>
  Reddit does not report match counts back — delivered counts reflect the identifiers submitted to Reddit, not the number Reddit matched.
</Note>

## Audience membership duration

Membership duration is how long a delivered identifier remains active in the destination audience before the destination platform expires it. It is distinct from the dataset's [retention policy](/concepts/primitives/dataset-retention-policies) (which governs data stored in Narrative) and the interface's [refresh window](/concepts/data-activation/connector-interfaces) (which governs how stale the source dataset may get).

| Field        | Value |
| ------------ | ----- |
| Configurable | No    |
| Setting      | —     |
| Default      | —     |
| Applies      | —     |

The connector does not set an expiration on delivered identifiers — Reddit's customer list API has no membership duration parameter.

***

## Related content

<CardGroup cols={2}>
  <Card title="Data Activation Overview" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    Understand how connectors deliver data
  </Card>

  <Card title="Hashing PII" icon="hashtag" href="/guides/ingestion/hashing-pii">
    Prepare identifiers for Reddit
  </Card>

  <Card title="Structuring Audiences" icon="sitemap" href="/guides/activation/audience-strategies">
    Organize datasets for delivery
  </Card>

  <Card title="Schema Incompatibility Errors" icon="plug-circle-exclamation" href="/reference/errors/dataset-schema-connector-incompatible">
    Resolve errors when a dataset schema doesn't match a connector
  </Card>
</CardGroup>