Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Adds or removes email addresses on an X Ads Do Not Reach list
| App | X Ads |
| Operation ID | x_ads_add_users_to_do_not_reach_list |
| 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 Do Not Reach list. |
do_not_reach_list_id | string or SelectItem | Yes | - | Do Not Reach list ID. Find it with x_ads_list_do_not_reach_lists. |
identifier_type | enum (email, phone_number) | No | email | Identifier type for this batch (one type per run): email (default) or phone_number. |
users | string or array of string | Yes | - | The identifiers to suppress, as a list or comma/newline separated text. Plain values are normalized per X’s rules and SHA256-hashed automatically; already-hashed 64-character values pass through. |
remove | boolean | No | False | Remove these identifiers from the list instead of adding them. |
expires_at | string | No | - | When the suppression expires: ISO 8601 or a Unix timestamp, under 13 months out. X keeps the entries until it decides otherwise when omitted. |
| 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 emails were submitted.