Adds users to, removes users from, or replaces the users in an existing custom audience.
Each call queues an operation rather than changing the audience immediately. The response describes the queued operation, not the resulting audience — the audience's new size appears after the daily job runs.
End Point POST https://business.newsbreak.com/business-api/v1/audience/update/{audienceId}
Header
| Field | Required | Data Type | Description |
|---|---|---|---|
| Access-Token | Y | string | Authorized access token. |
| Content-Type | Y | string | multipart/form-data |
Path Parameters
| Field | Required | Data Type | Description |
|---|---|---|---|
| audienceId | Y | string | ID of the audience to update. |
Request Parameters
| Field | Required | Data Type | Description |
|---|---|---|---|
| file | Y | binary | CSV of SHA-256 hashed identifiers, one per line, no header. Max 100 MB. |
| operation | Y | enumerate | What to do with the file's users. Available values: ADD, DELETE (remove), REPLACE. |
The file must use the same identifier type the audience was created with — fileType is fixed at creation and cannot be changed by an update.
Example
curl -X 'POST' \
'https://business.newsbreak.com/business-api/v1/audience/update/1234567890123456789' \
-H 'Access-Token: {{Access-Token}}' \
-F 'file=@/Users/tom/Documents/churned.csv' \
-F 'operation=DELETE'Response Parameters
| Field | Data Type | Description |
|---|---|---|
| code | int | Status code, see Return Codes |
| errMsg | string | Error message when code!=0 |
| data | object | The queued operation. |
| .id | string | Operation ID. |
| .audienceId | string | ID of the audience the operation applies to. |
| .operation | string | ADD, DELETE or REPLACE, as supplied. |
| .status | string | QUEUED until the daily job applies the operation, then AVAILABLE. |
| .size | int | Number of users the operation matched. Absent until processing completes. |
| .createTime | string | Time the operation was queued, Unix seconds. |
Example
{
"code": 0,
"data": {
"id": "9876543210987654321",
"audienceId": "1234567890123456789",
"operation": "DELETE",
"status": "QUEUED",
"createTime": "1755600000"
}
}Errors — same file-validation codes as Create (48026–48029). 403 if the token's user cannot manage ads on the account that owns the audience.