Create Audience - Markifact

Creates a Snapchat audience segment: a Customer List, a lookalike, an app event or website (Snap Pixel) event audience, or an ad engagement audience. Add users to Customer Lists with snapchat_ads_add_users_to_audience; include or exclude audiences in ad squad targeting.


App	Snapchat Ads
Operation ID	`snapchat_ads_create_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 to create the audience in.
`audience_name`	string	Yes	-	Name of the audience segment. Max 375 characters.
`description`	string	No	-	Optional description of the audience.
`audience_type`	string or SelectableOption	No	`{'value': 'CUSTOMER_LIST', 'label': 'Customer List'}`	CUSTOMER_LIST (default) creates an empty Customer List segment (source_type FIRST_PARTY); add hashed users with snapchat_ads_add_users_to_audience afterwards. LOOKALIKE creates a lookalike segment modeled on an existing seed segment. MOBILE_APP_EVENTS: people who triggered events in your app (needs snap_app_id and events). WEBSITE_EVENTS: people who triggered Snap Pixel events (needs pixel_id and events). AD_ENGAGEMENT: people who engaged with your ads (needs engagement_specs). Event and engagement audiences fill automatically and are excluded or included in ad squad targeting segments.
`retention_in_days`	integer	No	-	How long users stay in the segment, in days, up to 395. Default: 180, or 395 for AD_ENGAGEMENT.
`events`	array of enum (`APP_INSTALL`, `PURCHASE`, `SAVE`, `START_CHECKOUT`, `ADD_CART`, `VIEW_CONTENT`, `ADD_BILLING`, `SIGN_UP`, …)	No	-	MOBILE_APP_EVENTS and WEBSITE_EVENTS only: events that put someone in the audience; anyone who triggered ANY of them within retention_in_days joins. For example [‘ADD_CART’, ‘START_CHECKOUT’] or [‘PURCHASE’].
`snap_app_id`	string	No	-	MOBILE_APP_EVENTS only: the Snap App ID connected to the ad account (sent as mobile_metadata.mobile_snapkit_id). Existing MOBILE audiences in snapchat_ads_list_audiences show it under mobile_metadata.
`pixel_id`	string or SelectItem	No	-	WEBSITE_EVENTS only: the Snap Pixel of the ad account, from snapchat_ads_list_pixels.
`engagement_specs`	array of EngagementSpec	No	-	AD_ENGAGEMENT only: engagements that put someone in the audience; matching ANY spec is enough. For example [{“engagement_type”: “SNAP_ADS_SWIPE_UP”, “source_type”: “CAMPAIGN”, “source_id”: “<campaign id>”}].
`seed_segment_id`	string or SelectItem	No	-	LOOKALIKE only: the existing segment to model the lookalike on (sent as creation_spec.seed_segment_id). The seed must be targetable (READY).
`lookalike_country`	string	No	-	LOOKALIKE only: ISO-2 country code the lookalike expands into (sent as creation_spec.country), for example US.
`lookalike_type`	string or SelectableOption	No	`{'value': 'BALANCE', 'label': 'Balance'}`	LOOKALIKE only: BALANCE (default, mix of similarity and reach), SIMILARITY (closest to the seed), or REACH (largest audience). Sent as creation_spec.type.

EngagementSpec

Field	Type	Required	Default	Description
`engagement_type`	enum (`SNAP_ADS_SWIPE_UP`, `SNAP_ADS_TOP_VIEW_THRU_100`, `PROMOTED_STORY_TAP`, `CREATIVE_TOOLS_USE`, `PAID_IMPRESSIONS`, `NATIVE_LEAD_GEN_SUBMITTED`)	Yes	-	SNAP_ADS_SWIPE_UP (clicked an image or video ad), SNAP_ADS_TOP_VIEW_THRU_100 (watched a video ad to the end), PROMOTED_STORY_TAP (opened a Story ad), CREATIVE_TOOLS_USE (shared or saved a Lens or Filter), PAID_IMPRESSIONS (was served an ad), NATIVE_LEAD_GEN_SUBMITTED (submitted a lead form).
`source_type`	enum (`AD_ACCOUNT`, `CAMPAIGN`, `AD_SQUAD`)	Yes	-	Entity the engagement happened on.
`source_id`	string	Yes	-	ID of that ad account, campaign or ad squad, in the audience’s ad account.

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 the created Snapchat audience details. Fields: audience_id, audience_name, source_type, status, targetable_status