> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

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