Makes a custom audience available to other ad accounts you manage, so their ad sets can target it.
Warning: sharing is additive and cannot be undone through the API. There is no unshare endpoint. Confirm the target account IDs before calling.
End Point POST https://business.newsbreak.com/business-api/v1/audience/share/{audienceId}
Header
| Field | Required | Data Type | Description |
|---|---|---|---|
| Access-Token | Y | string | Authorized access token. |
| Content-Type | Y | string | application/json |
Path Parameters
| Field | Required | Data Type | Description |
|---|---|---|---|
| audienceId | Y | string | ID of the audience to share. |
Request Parameters
| Field | Required | Data Type | Description |
|---|---|---|---|
| adAccountIds | Y | string[] | Accounts to share with. You must be able to manage ads on every account listed. |
Sharing an account that already has access is a no-op, so the call is safe to retry.
Example
curl -X 'POST' \
'https://business.newsbreak.com/business-api/v1/audience/share/1234567890123456789' \
-H 'Access-Token: {{Access-Token}}' \
-H 'Content-Type: application/json' \
-d '{"adAccountIds": ["7654321", "7654322"]}'Response Parameters
Same object as Get a Custom Audience, with sharedAdAccountIds reflecting the new set.
Example
{
"code": 0,
"data": {
"id": "1234567890123456789",
"name": "Spring campaign customers",
"adAccountId": "1234567",
"type": "FILE",
"status": "AVAILABLE",
"size": 48213,
"fileType": "EMAIL",
"sharedAdAccountIds": ["1234567", "7654321", "7654322"],
"createTime": "1755500000",
"updateTime": "1755590000"
}
}Errors
| Code | Meaning |
|---|---|
| 403 | You cannot manage ads on the owning account, or on one of the target accounts; or the audience is a NewsBreak-provided audience, which cannot be re-shared. |
## Return codes to add to the existing codes article
| Code | Description |
|---|---|
| 48026 | Audience file is missing, empty, not a .csv, or holds no identifiers |
| 48027 | Audience file is over the 100 MB limit |
| 48028 | An audience file line is not a single 64-character SHA-256 hash — the message names the line |
| 48029 | Audience file holds too many rows |