Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Removes users from an X (Twitter) Ads custom audience, hashing identifiers the same way they were added
| App | X Ads |
| Operation ID | x_ads_remove_users_from_audience |
| Type | Action |
| Connection | x_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Select the X Ads account that owns the audience. |
audience_id | string or SelectItem | Yes | - | X Ads custom audience ID. |
identifier_type | enum (email, phone_number, device_id, handle, twitter_id, partner_user_id) | No | email | Identifier type for this batch (one type per run): email (default), phone_number, device_id, handle, twitter_id, or partner_user_id. Must match the type the users were added with. |
users | string or array of string | Yes | - | The identifiers to remove, as a list or comma/newline separated text. Normalized and SHA256-hashed the same way as when adding, so plain values match what was uploaded. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
String
Returns a summary of how many users were submitted for removal.