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. |