Inviting a Partner to Connect Their Reddit Ads Account via the API

Use this guide to deliver audiences to a Reddit Ads account that someone else owns, such as a client or partner. You create an invite link over the API and send it to the person who manages that account. That person opens the link, signs in to Reddit, and approves Narrative. They don’t need a Narrative login. Once they approve, a profile appears in your company with every ad account their Reddit user can manage. Approval on Reddit is a one-time step per profile. Every delivery after that runs from your API key. To deliver to your own Reddit Ads account, you don’t need an invite. Follow Connect your Reddit Ads account instead. Every request in this guide goes to the Reddit connector with an installation token. Before you start, complete the prerequisites and set up API access.

1. Create the invite

curl -s -X POST https://reddit.narrativeconnectors.com/app-invites \
  -H "Authorization: Bearer $INSTALLATION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "app_invite_connect",
    "display_name": "Example Brand",
    "invitee_name": "Example Brand ads team"
  }'
# → 201 {"type": "app_invite_connect", "id": "<INVITE_ID>", "activated_at": null,
#        "app": {"id": 23, "name": "Reddit Connector", "slug": "reddit_connector"},
#        "code": "<INVITE_CODE>", "display_name": "Example Brand",
#        "installation_id": <INSTALLATION_ID>, "invitee_name": "Example Brand ads team",
#        "status": "pending", "tags": [],
#        "url": "https://reddit.narrativeconnectors.com/app/invites?code=<INVITE_CODE>", ...}

Field	Meaning
`type`	`app_invite_connect` creates a new profile. To re-authorize an existing profile, see Reconnect a profile
`display_name`	The name of the profile the invite creates. The invitee sees it on the invite page
`invitee_name`	The person or organization receiving the invite. The invitee sees it on the invite page

Record the invite id to track the invite. Anyone who holds the url or code can complete the invite, so send it only to the person who should connect the account.

2. Send the link

Send the url from the response to the person who manages the Reddit Ads account. They open it in a browser, sign in to Reddit, and approve Narrative’s request to read and manage their ads. To preview what the invitee sees, read the invite by its code. This request needs no credential:

curl -s https://reddit.narrativeconnectors.com/app-invites/codes/{invite_code}
# → {"type": "app_invite_connect", "id": "<INVITE_ID>",
#    "app": {"id": 23, "name": "Reddit Connector", "slug": "reddit_connector"},
#    "company": {"id": 1234, "name": "Example Company", ...},
#    "display_name": "Example Brand", "invitee_name": "Example Brand ads team",
#    "status": "pending",
#    "url": "https://reddit.narrativeconnectors.com/app/invites?code=<INVITE_CODE>"}

3. Check the invite

curl -s https://reddit.narrativeconnectors.com/app-invites/{invite_id} \
  -H "Authorization: Bearer $INSTALLATION_TOKEN"
# → {"type": "app_invite_connect", "id": "<INVITE_ID>", "activated_at": null,
#    "display_name": "Example Brand", "status": "pending", ...}

When the invitee approves Narrative, status changes from pending to active and activated_at records the time. To list every invite on your installation:

curl -s https://reddit.narrativeconnectors.com/app-invites \
  -H "Authorization: Bearer $INSTALLATION_TOKEN"
# → {"records": [{"type": "app_invite_connect", "id": "<INVITE_ID>",
#    "activated_at": "2026-09-22T10:41:00Z", "display_name": "Example Brand",
#    "status": "active", ...}]}

4. Find the new profile and its ad accounts

Once the invite is active, the profile appears in your profile list under the invite’s display_name:

curl -s https://reddit.narrativeconnectors.com/profiles \
  -H "Authorization: Bearer $INSTALLATION_TOKEN"
# → {"records": [{"id": "<PROFILE_ID>", "name": "Example Brand", "status": "enabled", ...}]}

curl -s https://reddit.narrativeconnectors.com/profiles/{profile_id}/ad-accounts \
  -H "Authorization: Bearer $INSTALLATION_TOKEN"
# → {"records": [{"id": "<AD_ACCOUNT_ID>", "name": "Example Ad Account"}]}

Record the profile id and the ad account id. The profile is ready for Custom Audience delivery.

Reconnect a profile

A reconnect invite asks the invitee to approve Narrative again for a profile you already have, for example when a different person now manages the Reddit Ads account. The profile keeps its ID, ad accounts, and connections, and uses the new Reddit authorization once the invitee approves.

curl -s -X POST https://reddit.narrativeconnectors.com/app-invites \
  -H "Authorization: Bearer $INSTALLATION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "app_invite_reconnect",
    "profile_id": "<PROFILE_ID>",
    "display_name": "Example Brand"
  }'
# → 201 {"type": "app_invite_reconnect", "id": "<INVITE_ID>", "activated_at": null,
#        "code": "<INVITE_CODE>", "display_name": "Example Brand",
#        "profile": {"id": "<PROFILE_ID>", ...}, "status": "pending",
#        "url": "https://reddit.narrativeconnectors.com/app/invites?code=<INVITE_CODE>", ...}

Send the url and track the invite the same way as in steps 2 and 3.

Withdraw an invite

Delete an invite to stop its link from working:

curl -s -X DELETE https://reddit.narrativeconnectors.com/app-invites/{invite_id} \
  -H "Authorization: Bearer $INSTALLATION_TOKEN"
# → 204

After that, reading the invite by its code returns 404.

Delivering Custom Audiences via the API

Deliver hashed emails to a Reddit Custom Audience

App Invites

Onboard partners with shareable invitation links

Reddit Connector

Supported identifiers, profiles, and invites

API Keys

Create and rotate keys for programmatic access

Overview

Platform

Data Ingestion

Data Planes

Querying with NQL

Data Collaboration

Identity Resolution

Data Activation

Audience Studio

Connectors

Connector APIs

Compliance

Rosetta Stone

Account Settings

Workflows

Webhooks

Data Collaboration MCP Server

Tools

SDKs

Inviting a Partner to Connect Their Reddit Ads Account via the API

1. Create the invite

2. Send the link

3. Check the invite

4. Find the new profile and its ad accounts

Reconnect a profile

Withdraw an invite

Delivering Custom Audiences via the API

App Invites

Reddit Connector

API Keys

​1. Create the invite

​2. Send the link

​3. Check the invite

​4. Find the new profile and its ad accounts

​Reconnect a profile

​Withdraw an invite

​Related content

Delivering Custom Audiences via the API

App Invites

Reddit Connector

API Keys

1. Create the invite

2. Send the link

3. Check the invite

4. Find the new profile and its ad accounts

Reconnect a profile

Withdraw an invite

Related content