---
title: "Create a RMN partnership invite"
method: POST
path: "/businesses/{business_id}/rmn/partners/{partner_id}/invite"
tags: ["business_access_invite"]
---

# Create a RMN partnership invite

`POST /businesses/{business_id}/rmn/partners/{partner_id}/invite`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/rmn/partners/{partner_id}/invite`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:write`

**This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**

Creates a RMN partnership invite from an RMN to a potential Brand. Currently, invites from Brands to RMNs are not supported.

## Path parameters

- `business_id` string, required
- `partner_id` string, required

## Request body

- RmnPartnershipInviteCreate: Resource create operation model.
  - `brand_invite_details` BrandInviteDetailsCreate: Details supplied by the Brand when creating an invite to an RMN.
    - `rmn_dedicated_ad_account_id` string
  - `rmn_invite_details` RmnInviteDetailsCreate: Details supplied by the RMN when creating an invite to a Brand.
    - `asset_id_to_permissions` RmnAssetIdToPermissions[]: A typed list of asset permissions to grant as part of the RMN partnership invite.
      - union: Typed asset permissions for an RMN invite.
        - object: Catalog access to grant as part of an RMN invite. Catalogs always receive CATALOGS_MANAGER.
          - `asset_type` 'CATALOG', required
          - `asset_id` string, required
        - object: Pinner-list access to grant as part of an RMN invite. Pinner lists always receive BIZ_PINNER_LIST_SHARER.
          - `asset_type` 'PINNER_LIST', required
          - `asset_id` string, required
        - object: Conversion-segment access to grant as part of an RMN invite.
          - `asset_type` 'CONVERSION_SEGMENT', required
          - `asset_id` string, required
          - `permissions` RmnConversionSegmentPermission[], required
    - `domain_restrictions` string[]: A list of domains restricted by RMN for the Brand business.

## Response `200`

The request has succeeded.

- RmnPartnershipInvite: RMN partnership invite create payload and response data.
  - `business_id` string, required
  - `invite` RmnPartnershipInviteEntry, required: An entry mapping a partner business to its created RMN partnership invite
    - `partner_id` string, required
    - `invite_id` string, required

## Other responses

- `201`: Resource create operation completed successfully.
- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/businesses/:business_id/rmn/partners/:partner_id/invite/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/19899fd1c8f3?raw)
