---
title: "Update audience sharing from an ad account to businesses"
method: PATCH
path: "/ad_accounts/{ad_account_id}/audiences/businesses/shared"
tags: ["audience_sharing"]
---

# Update audience sharing from an ad account to businesses

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

## Request

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

From an ad account, share a specific audience with a business account, or revoke access to a previously shared audience. Only the audience owner account can share the audience. The recipient business account must be in the same business hierarchy as the business owner of the ad account.

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

## Path parameters

- `ad_account_id` string, required

## Request body

- AdAccountToBusinessSharedAudienceUpdateWithRequiredBody: 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_business_ids` PinterestLibIntegerFormatType[], required: Business IDs to share with or revoke from (request) / that received the audience (response).

## Response `200`

The request has succeeded.

- AdAccountToBusinessSharedAudience
  - `audience_id` string, required
  - `permissions` Role[]: Permissions granted to the recipients.
  - `recipient_business_ids` PinterestLibIntegerFormatType[], required: Business 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_business_ids`
  - removed `#/components/schemas/SharedAudienceCommon, subschema #2: BusinessSharedAudience` 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/ad_accounts/:ad_account_id/audiences/businesses/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)