> ## 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 Snapchat audience segment: a Customer List or a lookalike of an existing segment

Creates a Snapchat audience segment: a Customer List or a lookalike of an existing segment. Add users to Customer Lists with snapchat\_ads\_add\_users\_to\_audience.

| | |
| - | - |
| **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. |
| `retention_in_days` | integer | No | `180` | How long users stay in the segment, 1 to 180 days. Default: 180. |
| `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. |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.