Create Audience

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

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)