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