---
title: "Update audience sharing from a business to ad accounts"
method: PATCH
path: "/businesses/{business_id}/audiences/ad_accounts/shared"
tags: ["audience_sharing"]
---

# Update audience sharing from a business to ad accounts

`PATCH /businesses/{business_id}/audiences/ad_accounts/shared`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/audiences/ad_accounts/shared`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:write`
- TypeScript: <https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/businesses/:business_id/audiences/ad_accounts/shared/patch.ts> (a function with typed inputs; its response is checked against the schema)

From a business, share a specific audience with other ad account(s), or revoke access to a previously shared audience.

- If the business is the owner of the audience, it can share with any ad account within the same business hierarchy.
- If the business is the recipient of the audience, it can share with any of its owned ad accounts.

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

## Path parameters

- `business_id` string, required

## Request body

- BusinessToAdAccountSharedAudienceUpdateWithRequiredBody: Resource create or update operation model with required body fields (no OptionalProperties).
  - `audience_id` string, required
  - `operation_type` 'SHARE' | 'REVOKE', required: Operation type to share a specific audience or revoke access to a previously shared audience
  - `recipient_account_ids` PinterestLibIntegerFormatType[], required: Ad account IDs to share with or revoke from (request) / that received the audience (response).

## Response `200`

The request has succeeded.

- BusinessToAdAccountSharedAudience
  - `audience_id` string, required
  - `permissions` Role[]: Permissions granted to the recipients.
  - `recipient_account_ids` PinterestLibIntegerFormatType[], required: Ad account IDs to share with or revoke from (request) / that received the audience (response).

## Other responses

- `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-06-04** (v5) `b698c180678a`: 3 breaking, 1 warning, 8 info
  - added the new required request property `audience_id`
  - added the new required request property `operation_type`
  - added the new required request property `recipient_account_ids`
  - removed `#/components/schemas/SharedAudienceCommon, subschema #2: SharedAudience` from the request body `allOf` list
  - …8 more
- **2025-04-04** (v5) `10f9eba4ad97`: 3 warning
  - added the new `CATALOGS_VIEWER` enum value to the `allOf[#/components/schemas/SharedAudienceResponseCommon]/permissions/items/` response property for the response status `200`
  - added the new `FINANCE_EDIT` enum value to the `allOf[#/components/schemas/SharedAudienceResponseCommon]/permissions/items/` response property for the response status `200`
  - added the new `FINANCE_VIEW` enum value to the `allOf[#/components/schemas/SharedAudienceResponseCommon]/permissions/items/` response property for the response status `200`
- **2024-08-14** (v5) `89c27ed39cfd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/businesses/:business_id/audiences/ad_accounts/shared/patch.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/b698c180678a?raw)