> ## 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. # Inviting a Partner to Connect Their Reddit Ads Account via the API > Send a partner an invite link so they can connect a Reddit Ads account they own, then find the new profile and deliver audiences to it 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](/guides/connector-apis/reddit#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](/guides/connector-apis/reddit#prerequisites) and [set up API access](/guides/connector-apis/reddit#set-up-api-access). ## 1. Create the invite ```bash theme={null} 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": "", "activated_at": null, # "app": {"id": 23, "name": "Reddit Connector", "slug": "reddit_connector"}, # "code": "", "display_name": "Example Brand", # "installation_id": , "invitee_name": "Example Brand ads team", # "status": "pending", "tags": [], # "url": "https://reddit.narrativeconnectors.com/app/invites?code=", ...} ``` | Field | Meaning | | - | - | | `type` | `app_invite_connect` creates a new profile. To re-authorize an existing profile, see [Reconnect a profile](#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: ```bash theme={null} curl -s https://reddit.narrativeconnectors.com/app-invites/codes/{invite_code} # → {"type": "app_invite_connect", "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="} ``` ## 3. Check the invite ```bash theme={null} curl -s https://reddit.narrativeconnectors.com/app-invites/{invite_id} \ -H "Authorization: Bearer $INSTALLATION_TOKEN" # → {"type": "app_invite_connect", "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: ```bash theme={null} curl -s https://reddit.narrativeconnectors.com/app-invites \ -H "Authorization: Bearer $INSTALLATION_TOKEN" # → {"records": [{"type": "app_invite_connect", "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`: ```bash theme={null} curl -s https://reddit.narrativeconnectors.com/profiles \ -H "Authorization: Bearer $INSTALLATION_TOKEN" # → {"records": [{"id": "", "name": "Example Brand", "status": "enabled", ...}]} curl -s https://reddit.narrativeconnectors.com/profiles/{profile_id}/ad-accounts \ -H "Authorization: Bearer $INSTALLATION_TOKEN" # → {"records": [{"id": "", "name": "Example Ad Account"}]} ``` Record the profile `id` and the ad account `id`. The profile is ready for [Custom Audience delivery](/guides/connector-apis/reddit/audiences-api). ## 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. ```bash theme={null} 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": "", "display_name": "Example Brand" }' # → 201 {"type": "app_invite_reconnect", "id": "", "activated_at": null, # "code": "", "display_name": "Example Brand", # "profile": {"id": "", ...}, "status": "pending", # "url": "https://reddit.narrativeconnectors.com/app/invites?code=", ...} ``` Send the `url` and track the invite the same way as in [steps 2 and 3](#2-send-the-link). ## Withdraw an invite Delete an invite to stop its link from working: ```bash theme={null} 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`. *** ## Related content Deliver hashed emails to a Reddit Custom Audience Onboard partners with shareable invitation links Supported identifiers, profiles, and invites Create and rotate keys for programmatic access This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.