---
title: "Remove Contacts from Audience"
method: POST
path: "/v1/audiences/{audience_id}/contacts/remove"
tags: ["Audiences"]
---

# Remove Contacts from Audience

`POST /v1/audiences/{audience_id}/contacts/remove`

## Request

- Base URL: `https://api.monaco.com`
- URL: `https://api.monaco.com/v1/audiences/{audience_id}/contacts/remove`
- Auth: none declared

Removes the given `contact_ids` from an audience. Idempotent — IDs not in the audience are ignored. Any per-contact failures are returned in `failures`.

## Path parameters

- `audience_id` string, uuid, required

## Request body

- AudienceContactsRequest
  - `contact_ids` string[], required: IDs of the contacts to add or remove

## Response `200`

Successful Response

- PublicItemResponseAudienceContactsResponse
  - `data` AudienceContactsResponse, required
    - `audience_id` string, required: ID of the audience that was modified
    - `failures` AudienceContactFailureGroup[]: Contacts that exist but could not be added or removed, grouped by reason
      - `reason` string, required: Reason code for the failure
      - `contact_ids` string[], required: Contact IDs that failed for this reason
  - `meta` ResponseMeta
    - `timestamp` string, date-time: Server timestamp of the response

## Other responses

- `4XX`: Client error

## Changes

- **2026-11-03** `fc720ada2a81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monaco/apis/monaco-public-api/changes/v1/audiences/:audience_id/contacts/remove/post.md)

---

[API](https://skmtc.dev/monaco/apis/monaco-public-api.md) - [All operations](https://skmtc.dev/monaco/apis/monaco-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monaco/apis/monaco-public-api/revisions/fc720ada2a81?raw)