> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Users To Do Not Reach List

> Adds or removes email addresses on an X Ads Do Not Reach list

Adds or removes email addresses on an X Ads Do Not Reach list. Emails are lowercased and SHA256-hashed automatically before upload.

|                       |                                        |
| --------------------- | -------------------------------------- |
| **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)                  |

## Inputs

| 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.                                                       |

### SelectItem

| 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. |

## Output

**Type**: `String`

Returns a summary of how many emails were submitted.