Add Users To Audience - Markifact

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.