---
title: "Remove users from audience"
method: DELETE
path: "/messenger/1/audiences/{audienceId}/users"
tags: ["channels", "messenger", "audiences-messenger"]
---

# Remove users from audience

`DELETE /messenger/1/audiences/{audienceId}/users`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/messenger/1/audiences/{audienceId}/users`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Remove users from a custom audience. Accepts the same hashed user data as the upload endpoint. Maximum 10,000 users per request.

## Path parameters

- `audienceId` string, required

## Request body

- Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77AudienceUsersRequest
  - `data` Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77AudienceUser[], required: Users to match against Meta's user database. Each entry must contain a hashed phone number, a hashed email address, or both. Providing both identifiers for the same person increases the chance of a match.
    - `phone` string: SHA-256 hashed phone number. Normalize the value before hashing: remove symbols, letters, and any leading zeroes, keeping only the country code and digits (e.g. "(+84) 091-2345678" becomes "84912345678" before hashing). The hashed value must be a 64-character lowercase hexadecimal string.
    - `email` string: SHA-256 hashed email address. Normalize the value before hashing: trim surrounding whitespace and lowercase it (e.g. " User@Example.com " becomes "user@example.com" before hashing). The hashed value must be a 64-character lowercase hexadecimal string.

## Response `200`

Users removed successfully.

- Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77AudienceUsersResponse
  - `audienceId` string: Meta custom audience ID.
  - `numReceived` integer: Number of entries received.
  - `numInvalidEntries` integer: Number of invalid entries.
  - `subscriptionInfo` Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77SubscriptionInfo: Messenger subscription info.
    - `numSubscribersReceived` integer: Number of subscribers matched.
    - `numSubscribersInvalidEntries` integer: Number of invalid subscriber entries.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Audience not found.
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)