> ## 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 Audience

> Adds users to an X (Twitter) Ads custom audience by email, phone number, device id, handle, X user id, or partner user id

Adds users to an X (Twitter) Ads custom audience by email, phone number, device id, handle, X user id, or partner user id. Identifiers are normalized and SHA256-hashed automatically before upload.

|                       |                               |
| --------------------- | ----------------------------- |
| **App**               | X Ads                         |
| **Operation ID**      | `x_ads_add_users_to_audience` |
| **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 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 (with country code), device\_id (IDFA/AdID/Android id), handle (@username), twitter\_id, or partner\_user\_id.                                                                                                                                                  |
| `users`           | string or array of string                                                              | Yes      | -       | The identifiers, as a list or comma/newline separated text. Plain values are normalized per X's rules (emails and handles lowercased, @ stripped, phone formatting removed) and SHA256-hashed automatically; already-hashed 64-character values pass through as-is, and partner\_user\_id is never hashed. Large lists are chunked automatically. |
| `effective_at`    | string                                                                                 | No       | -       | When the memberships take effect: ISO 8601 or a Unix timestamp. Defaults to now.                                                                                                                                                                                                                                                                  |
| `expires_at`      | string                                                                                 | No       | -       | When the memberships expire: ISO 8601 or a Unix timestamp; must be after effective\_at. Defaults to 13 months out, X's maximum.                                                                                                                                                                                                                   |

### 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 users were submitted.