v29

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

audience_sharing

Update audience sharing from a business to ad accounts

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.

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

business_idstring required

Unique identifier of the requesting business.

audience_idstring required

operation_type'SHARE' | 'REVOKE' required

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

recipient_account_idsPinterestLibIntegerFormatType[] required

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

The request has succeeded.

audience_idstring required

permissionsRole[]

Permissions granted to the recipients.

recipient_account_idsPinterestLibIntegerFormatType[] required

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

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