v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

audience_sharing

Update audience sharing from an ad account to businesses

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.

patch/ad_accounts/{ad_account_id}/audiences/businesses/shared

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

audience_idstring required

operation_type'SHARE' | 'REVOKE' required

Operation type to share a specific audience or revoke access to a previously shared audience

recipient_business_idsPinterestLibIntegerFormatType[] required

Business IDs to share with or revoke from (request) / that received the audience (response).

Response

The request has succeeded.

audience_idstring required

permissionsRole[]

Permissions granted to the recipients.

recipient_business_idsPinterestLibIntegerFormatType[] required

Business IDs to share with or revoke from (request) / that received the audience (response).

Example response

{
  "permissions": [
    "RESOURCE_PINNER_LIST_READER",
    "RESOURCE_PINNER_LIST_OWNER"
  ]
}