Create Audience - Markifact

Creates a Spotify audience: a custom audience built from a customer list, website events tracked by a dataset or pixel, or engagement with your ads, or a lookalike audience grown from an existing one. A CUSTOMER_LIST audience starts empty; its members are uploaded separately.


App	Spotify Ads
Operation ID	`spotify_ads_create_audience`
Type	Action
Connection	`spotify_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 Spotify Ads account to create the audience in.
`audience_type`	enum (`CUSTOM`, `LOOKALIKE`)	Yes	-	CUSTOM builds an audience from your own data or ad engagement; LOOKALIKE finds users similar to an existing audience and needs seed_audience_id.
`name`	string	Yes	-	Audience name, 2 to 80 characters.
`description`	string	No	-	Short description of the audience, up to 80 characters.
`subtype`	enum (`CUSTOMER_LIST`, `WEB_EVENT`, `AD_ENGAGEMENT`, `LIVERAMP`)	No	-	CUSTOM audiences only. How the audience is built: CUSTOMER_LIST (a list you upload), WEB_EVENT (visitors tracked by a dataset or pixel), AD_ENGAGEMENT (people who saw or clicked your ads), or LIVERAMP.
`seed_audience_id`	string or SelectItem	No	-	LOOKALIKE audiences only, and required for them: the existing audience to find similar users to.
`dataset_ids`	string or array of string	No	-	WEB_EVENT subtype: measurement datasets or pixels supplying the events. Accepts a list or a comma-separated string. Get ids from spotify_ads_list_pixels.
`included_events`	string or array of string	No	-	WEB_EVENT subtype: only include users who triggered these events, for example PURCHASE or ADDTOCART. Use the event names your dataset reports, from spotify_ads_list_pixels with events included.
`excluded_events`	string or array of string	No	-	WEB_EVENT subtype: exclude users who triggered these events, for example PURCHASE to retarget people who did not buy.
`lookback_days`	enum (`30`, `60`, `90`, `180`)	No	-	WEB_EVENT subtype: how far back to look for events. 30, 60, 90 or 180 days.
`campaign_ids`	string or array of string	No	-	AD_ENGAGEMENT subtype: build the audience from people who engaged with these campaigns. Accepts a list or a comma-separated string.
`ad_set_ids`	string or array of string	No	-	AD_ENGAGEMENT subtype: build the audience from people who engaged with these ad sets. Accepts a list or a comma-separated string.
`exposure_type`	enum (`IMPRESSIONS`, `CLICKS`)	No	-	AD_ENGAGEMENT subtype: count people who saw the ads (IMPRESSIONS) or who clicked them (CLICKS).
`audience_id`	string	No	-	Advanced: supply your own UUID for the audience instead of letting Spotify assign one.

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: Dict Returns the created audience including id, name, type, subtype, status and size. Fields: dynamic (depend on the inputs)