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.