Add Users To Audience

Adds users to a Snapchat Customer List audience by email, phone number, or mobile ad ID. Identifiers are normalized and SHA-256 hashed automatically.


App	Snapchat Ads
Operation ID	`snapchat_ads_add_users_to_audience`
Type	Action
Connection	`snapchat_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 Snapchat Ads account that owns the audience.
`audience_id`	string or SelectItem	Yes	-	Snapchat Customer List audience segment ID.
`schema_type`	string or SelectableOption	No	`{'value': 'EMAIL_SHA256', 'label': 'Emails'}`	Identifier type for this batch (one type per run): EMAIL_SHA256 (default), PHONE_SHA256, or MOBILE_AD_ID_SHA256.
`users`	array of string or string	Yes	-	The identifiers, as a list or comma/newline separated text. Plain values (emails, phone numbers with country code, mobile ad IDs) are normalized per Snapchat’s rules and SHA-256 hashed automatically; already-hashed 64-character values are passed through as-is. Up to 100,000 identifiers per request (larger lists are chunked).

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.

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Type: Dict Returns how many users were submitted and processed. Fields: audience_id, schema_type, users_submitted, users_processed