Add Users To Audience

Adds users to a Snapchat Customer List audience by email, phone number, or mobile ad ID

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

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.

SelectableOption

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

Output

Type: Dict

Returns how many users were submitted and processed.

Fields: audience_id, schema_type, users_submitted, users_processed