Reddit Connector

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`
Hashed email (SHA256)	`hashed_email` (type `sha256_email`)
Email	`raw_email` (automatically normalized and hashed)
Apple IDFA	`apple_idfa`
Android Advertising ID (GAID)	`android_advertising_id`
Narrative ID	`narrative_id`

The connector also accepts the generic mobile_id_unique_identifier attribute when its type resolves to one of the identifiers above.

Hashed identifiers must use SHA256 — hashed emails with SHA-1 or MD5 hashes are skipped during delivery. See Hashing PII for Upload for formatting requirements.

Reddit customer lists do not accept phone numbers.

Installation

Navigate to the connector

In Narrative, go to Installed Apps and select Reddit Connector.

Create a profile

In the Profiles tab, click Add profile and provide:

Profile name — a unique name to identify this configuration
Profile description (optional) — a note describing the profile’s purpose

Click Create profile. Reddit grants are member-scoped, so there is no organization or account ID to supply up front.

Authorize with Reddit

Click Connect to Reddit. A new window opens for you to log 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. Narrative polls for the authorization and marks the profile Connected once it lands, so leave the connector page open until it does.

Review ad accounts

Expand the profile to see the ad accounts discovered for the authorized account. Click view to list them, or refresh to re-fetch them from Reddit if new ad accounts have been added.

Managing profiles

Each profile carries its own OAuth grant, and the Profiles tab shows the state of each one:

Reddit connection — whether the profile holds a valid Reddit grant. Only connected profiles can receive deliveries or back an opt-out connection.
Ad accounts — how many ad accounts the grant reached, with view to list them and refresh to re-seed them from Reddit.
Profile status — whether the profile is enabled.
Delete profile — removes the profile. Its grant goes with it, so any connection relying on it stops delivering.

Delivering audiences

When connecting a dataset to the Reddit Connector, you choose how the audience is created. To connect a dataset of opted-out users instead, see Opt-outs.

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
Dataset write mode	Append (default) or Overwrite. Defaults to the source dataset’s write mode. See Write modes.
Member TTL (days)	Append only. Removes a member this many days after the dataset last delivered it (1–28). Leave empty to keep members until an opt-out removes them.
Deliver all data	Whether to also deliver data written to the dataset in the 30 days before the connection is created. Unchecked, only data written after the connection is configured is delivered.

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.
Dataset write mode	Append (default) or Overwrite. Defaults to the source dataset’s write mode. See Write modes.
Deliver all data	Whether to also deliver data written to the dataset in the 30 days before the connection is created. Unchecked, only data written after the connection is configured is delivered.

Write modes

The dataset write mode decides what happens to an audience’s existing members when a new delivery arrives.

Mode	What each delivery does	Members leave the audience when
Append	Adds the delivered identifiers to the audience	An opt-out removes them
Append with a member TTL	Adds the delivered identifiers and restarts each one’s TTL clock	They have not appeared in a delivery for the TTL’s number of days, or an opt-out removes them
Overwrite	Replaces the audience’s members with the rows in the delivery: identifiers missing from it are removed, then new ones are added	A delivery arrives without them, or an opt-out removes them

Use Append with a TTL for rolling audiences such as “visited in the last 14 days”, where the dataset keeps adding recent activity and you want stale members to age out. Use Overwrite when each delivery is the complete, current audience. Each delivery carries one new dataset snapshot, which is why the setting defaults to the dataset’s own write mode. On an overwrite dataset, every snapshot is the full dataset, so an Overwrite connection keeps the audience matching the dataset. On an append dataset, every snapshot holds only the newly added rows, so an Overwrite connection shrinks the audience to the latest batch at each delivery. A member TTL is only available on new audiences. Reddit does not let anyone read a customer list’s members back, so on an existing audience the connector only knows what Narrative delivered. The write mode and TTL belong to the audience, not the connection. When several connections deliver into one audience, they must all use the same write mode and TTL. A connection with different settings is rejected with an error saying the audience is already synced with a different dataset write mode or member TTL.

Audience status in Reddit

A successful delivery in Narrative means the identifiers reached Reddit. It does not mean Reddit has finished matching them. Reddit matches customer lists asynchronously, and that can take up to 36 hours depending on list size and load on Reddit’s side. Until matching finishes, a newly created audience shows Invalid with a size of N/A in Reddit Audience Manager. This is expected and does not mean the delivery failed. Reddit also needs at least 1,000 matched Reddit users before an audience becomes usable. An audience that is still unusable after 36 hours most likely has too few matches, which is common with small test lists.

Narrative does not show Reddit’s match count. Delivered counts reflect the identifiers submitted to Reddit, not the number Reddit matched. Check the audience’s size in Reddit Audience Manager once processing finishes.

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 (which governs data stored in Narrative) and the interface’s refresh window (which governs how stale the source dataset may get).

Field	Value
Configurable	Yes — on new audiences with the Append write mode
Setting	Member TTL (days)
Range	1–28 days, or leave blank for no expiration
Default	No expiration — members stay until an opt-out removes them
Applies	Per member — each delivery that includes an identifier restarts its clock

Reddit’s customer list API has no membership duration parameter, so Narrative enforces the TTL itself. A daily job removes members the dataset has not delivered within the TTL, so a member can stay up to one day longer than the TTL. The TTL is set once for the audience and shared by every connection that delivers into it. Existing audiences and Overwrite connections have no TTL. See Write modes. Separately from any member TTL, Reddit expires a whole customer list one year after its last update.

Opt-outs

The Opt Out Configuration tab on the connector page connects a dataset of opted-out users to Reddit. Identifiers in the dataset are removed from every Reddit Custom Audience your company delivers to; the connection itself names no ad account and no audience.

Open the Opt Out Configuration tab

In Installed Apps, open Reddit Connector and select the Opt Out Configuration tab. The tab lists the datasets currently feeding opt-outs, with the dataset id, dataset name, and connection id for each connection.

Connect a dataset

Click Connect opt out dataset. The picker offers datasets that carry at least one identifier column Reddit’s audience delivery reads and that aren’t already wired up as an opt-out source.

Confirm the opt-out

A confirmation names the dataset you picked and the connector it applies to. Connecting it opts every identifier in the dataset out of Reddit and cannot be undone, so check the name before you click Accept.

Opt-out connections hang off a Reddit profile that has completed authorization, because the connector uses that profile’s grant to issue the removals. You need at least one connected profile before Connect opt out dataset becomes available.

Inviting partners

The Reddit Connector supports app invites, which let you onboard a partner without requiring them to have a Narrative account. In the App Invites tab, click Create invite and choose what the invite should do:

New profile — the invitee authorizes Reddit and a profile is created in your account, carrying their grant.
Update existing profile token — the invitee re-authorizes an existing profile you select, refreshing its grant without disturbing its ad accounts or connections.

Give the invite a display name to identify it in the list, and an invitee name for the person or organization receiving it. Both are required. Each invite in the list expands to show its status, its invite code, and the invite URL you share with the partner. An invite stays Pending until the invitee completes authorization, then becomes Active. Delete invite removes it and invalidates the link, and cannot be undone. For more details on how app invites work, see App Invites.