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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.