Audiences
Remove contacts from an audience
Take up to 5,000 contacts out of an audience without deleting them.
DELETE
/v1/audiences/{id}/contactsAPI keyRemoves contacts from the audience. The contacts stay in the project and in their other audiences. IDs that are not in the audience are ignored, so this call does not fail on unknown IDs.
This DELETE request takes a JSON body.
Path parameters
The audience ID.
Body parameters
1 to 5,000 contact IDs.
Response
removednumber
How many contacts were actually in the audience and are now removed.
Errors
| Status | Code | When |
|---|---|---|
| 400 | missing_body | The request has no body. |
| 400 | invalid_body | contactIds is missing, empty or has more than 5,000 entries. |
| 404 | audience_not_found | No audience with that ID in this project. |