Add/remove audience users
x_ads_audience_usersAdd or remove users from custom X audiences using emails, phones, or handles, with automatic SHA-256 hashing and no raw data logging. Supports up to 2500 users per call.
Instructions
Add (Update) or remove (Delete) members of a custom audience. Pass raw emails/phones/handles — this server SHA-256 hashes after X normalization (lowercase email, strip @, digits-only phone). Set hashed=true only if values are already hex SHA-256. Max 2500 users per call. Never log the raw list.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account_id": "<account_id>",
"custom_audience_id": "<custom_audience_id>",
"users": "<users>"
},
"name": "x_ads_audience_users"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| users | Yes | ||
| hashed | No | ||
| operation | No | Update | |
| account_id | Yes | Ads API account id from x_ads_list_accounts, e.g. 18ce55v2od2 | |
| custom_audience_id | Yes |