# Snapchat Ads

Source: https://pilot.braike.com/en/docs/regies/snapchat

The 37 tools Pilot MCP serves for Snapchat Ads: 18 read-only, and 19 that write with the €29 plan, taken from the server.

Pilot MCP serves **18 read-only tools** for Snapchat Ads, on every plan. With the €29 plan, it also serves **15** that create or change and **4** that delete. Their names start with `snapchat_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 18 |
| [Create and change (€29)](#modification) | 15 |
| [Delete (€29)](#suppression) | 4 |

## Other tools [#autres]

### `snapchat_get_ad` [#snapchat_get_ad]

**Snapchat Ads: Get Ad** · read-only · idempotent

Get details of a specific ad, with the ad account of its campaign (ad\_account\_id)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | yes | Ad ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_ad_account` [#snapchat_get_ad_account]

**Snapchat Ads: Get Ad Account** · read-only · idempotent

Get the details of one Snapchat ad account by ad\_account\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_get_ad_account_stats` [#snapchat_get_ad_account_stats]

**Snapchat Ads: Get Ad Account Stats** · read-only · idempotent

Get the spend of a Snapchat ad account over a time range, by granularity (DAY by default). Snapchat returns only spend at the ad account level: use get\_campaign\_stats, get\_ad\_squad\_stats or get\_ad\_stats for impressions, swipes and conversions.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `granularity` | `string` | no | Granularity of stats. Values: `"TOTAL"`, `"DAY"`, `"HOUR"`. Default: `"DAY"`. |
| `start_time` | `string` | yes | Start time ISO 8601 (e.g. 2025-01-01T00:00:00.000-00:00). |
| `end_time` | `string` | yes | End time ISO 8601. |
| `conversion_source_types` | `string` | no | Comma-separated conversion sources (web, app, total). |
| `swipe_up_attribution_window` | `string` | no | Swipe-up attribution window (e.g. 28\_DAY). |
| `view_attribution_window` | `string` | no | View attribution window (e.g. 7\_DAY). |

### `snapchat_get_ad_squad` [#snapchat_get_ad_squad]

**Snapchat Ads: Get Ad Squad** · read-only · idempotent

Get details of a specific ad squad, with the ad account of its campaign (ad\_account\_id)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_squad_id` | `string` | yes | Ad Squad ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_audience` [#snapchat_get_audience]

**Snapchat Ads: Get Audience** · read-only · idempotent

Get details of a specific audience segment

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `segment_id` | `string` | yes | Segment ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_audience_size` [#snapchat_get_audience_size]

**Snapchat Ads: Get Audience Size** · read-only · idempotent

Estimate the audience size range for a targeting spec (geos, demographics, interests...), with optional ad squad fields (type, placement, optimization\_goal...) that shape the estimate.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `targeting_spec` | `object` | yes | Targeting spec object (geos, demographics, interests, etc.). |
| `ad_squad` | `object` | no | Other ad squad fields of the estimate, e.g. \{ "type": "SNAP\_ADS", "placement": "CONTENT", "optimization\_goal": "SWIPES" \}. |

### `snapchat_get_campaign` [#snapchat_get_campaign]

**Snapchat Ads: Get Campaign** · read-only · idempotent

Get the details of one Snapchat campaign by campaign\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes | Campaign ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_creative` [#snapchat_get_creative]

**Snapchat Ads: Get Creative** · read-only · idempotent

Get the details of one Snapchat creative by creative\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `creative_id` | `string` | yes | Creative ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_media` [#snapchat_get_media]

**Snapchat Ads: Get Media** · read-only · idempotent

Get the details of one Snapchat media file by media\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `media_id` | `string` | yes | Media ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_pixel` [#snapchat_get_pixel]

**Snapchat Ads: Get Pixel** · read-only · idempotent

Get the details of one Snapchat pixel by pixel\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `pixel_id` | `string` | yes | Pixel ID. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_get_targeting_options` [#snapchat_get_targeting_options]

**Snapchat Ads: Get Targeting Options** · read-only · idempotent

Get available Snapchat targeting options by type and dimension: geo (country by default; with country\_code, its region, metro or postal\_code), demographics (age\_group, gender, languages, advanced\_demographics), device (os\_type, connection\_type, marketing\_name, carrier), interests, location categories.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `targeting_type` | `string` | yes | Targeting type to retrieve. Values: `"geo"`, `"demographics"`, `"device"`, `"carrier"`, `"interests_dlxs"`, `"interests_dlxc"`, `"interests_dlxp"`, `"interests_nln"`, `"location_categories"`, `"advanced_demographics"`. |
| `country_code` | `string` | no | Country code (e.g. fr): for geo, the country whose regions, metros or postal codes are listed; otherwise a filter. |
| `dimension` | `string` | no | Dimension within the type: required for demographics and device; for geo, region by default when country\_code is given. Values: `"country"`, `"region"`, `"metro"`, `"postal_code"`, `"age_group"`, `"gender"`, `"languages"`, `"advanced_demographics"`, `"os_type"`, `"connection_type"`, `"marketing_name"`, `"carrier"`. |
| `account_id` | `string` | no | Snapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace. |

### `snapchat_list_ad_squads` [#snapchat_list_ad_squads]

**Snapchat Ads: List Ad Squads** · read-only · idempotent

List all the ad squads of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_ads` [#snapchat_list_ads]

**Snapchat Ads: List Ads** · read-only · idempotent

List all the ads of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_audiences` [#snapchat_list_audiences]

**Snapchat Ads: List Audiences** · read-only · idempotent

List all audience segments under an ad account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_campaigns` [#snapchat_list_campaigns]

**Snapchat Ads: List Campaigns** · read-only · idempotent

List all the campaigns of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_creatives` [#snapchat_list_creatives]

**Snapchat Ads: List Creatives** · read-only · idempotent

List all the creatives of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_media` [#snapchat_list_media]

**Snapchat Ads: List Media** · read-only · idempotent

List all the media files of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

### `snapchat_list_pixels` [#snapchat_list_pixels]

**Snapchat Ads: List Pixels** · read-only · idempotent

List all the pixels of a Snapchat ad account (ad\_account\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `snapchat_create_ad` [#snapchat_create_ad]

**Snapchat Ads: Create Ad** · create or change, €29 plan · creates an object on each call

Create a new ad (PAUSED by default) under an ad squad. Change it with update\_ad, delete it with delete\_ad.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_squad_id` | `string` | yes | Ad Squad ID. |
| `name` | `string` | yes | Ad name. |
| `creative_id` | `string` | yes | Creative ID to associate with this ad. |
| `status` | `string` | no | Ad status. Values: `"ACTIVE"`, `"PAUSED"`. Default: `"PAUSED"`. |
| `type` | `string` | no | Ad type. Values: `"SNAP_AD"`, `"LONGFORM_VIDEO"`, `"APP_INSTALL"`, `"REMOTE_WEBPAGE"`, `"DEEP_LINK"`, `"STORY"`, `"AD_TO_LENS"`, `"AD_TO_CALL"`, `"AD_TO_MESSAGE"`, `"FILTER"`, `"LENS"`, `"LENS_REMOTE_WEBPAGE"`, `"LENS_APP_INSTALL"`, `"LENS_DEEP_LINK"`, `"COLLECTION"`, `"LEAD_GENERATION"`. Default: `"SNAP_AD"`. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_create_ad_squad` [#snapchat_create_ad_squad]

**Snapchat Ads: Create Ad Squad** · create or change, €29 plan · creates an object on each call

Create a new Snapchat ad squad in campaign\_id. Defaults: status PAUSED, type SNAP\_ADS, billing event IMPRESSION, automatic placement. Change it with update\_ad\_squad, delete it with delete\_ad\_squad.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes | Campaign ID. |
| `name` | `string` | yes | Ad squad name. |
| `status` | `string` | no | Status. Values: `"ACTIVE"`, `"PAUSED"`. Default: `"PAUSED"`. |
| `type` | `string` | no | Ad squad type. Values: `"SNAP_ADS"`, `"LENSES"`, `"FILTERS"`. Default: `"SNAP_ADS"`. |
| `placement_v2` | `object` | no | Placement configuration. |
| `optimization_goal` | `string` | no | Optimization goal (IMPRESSIONS, SWIPES, APP\_INSTALLS, etc.). |
| `bid_micro` | `number` | no | Bid amount in micro-currency. |
| `daily_budget_micro` | `number` | no | Daily budget in micro-currency. |
| `billing_event` | `string` | no | Billing event. Values: `"IMPRESSION"`, `"SWIPE"`. Default: `"IMPRESSION"`. |
| `start_time` | `string` | no | Start time ISO 8601. |
| `end_time` | `string` | no | End time ISO 8601. |
| `targeting` | `any` | no | Targeting spec object (geos, demographics, devices, etc.). |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_create_audience` [#snapchat_create_audience]

**Snapchat Ads: Create Audience** · create or change, €29 plan · creates an object on each call

Create a new audience segment under an ad account. Change it with update\_audience, delete it with delete\_audience.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Segment name. |
| `description` | `string` | no | Segment description. |
| `source_type` | `string` | yes | Audience source type. Values: `"FIRST_PARTY"`, `"ENGAGEMENT"`, `"PIXEL"`, `"MOBILE"`, `"LOOKALIKE"`, `"AD_ACCOUNT"`, `"SAVED_AUDIENCE"`, `"CUSTOMER_LIST"`. |
| `retention_in_days` | `number` | no | Retention period in days. Default: `180`. |

### `snapchat_create_audience_segment` [#snapchat_create_audience_segment]

**Snapchat Ads: Create Audience Segment** · create or change, €29 plan · creates an object on each call

Create a customer list audience segment for targeting. Change it with update\_audience, delete it with delete\_audience.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Segment name. |
| `description` | `string` | no | Segment description. |
| `source_type` | `string` | no | Segment source type. Values: `"FIRST_PARTY"`, `"ENGAGEMENT"`, `"PIXEL"`, `"THIRD_PARTY_UPLOADED"`. Default: `"FIRST_PARTY"`. |
| `retention_in_days` | `number` | no | Retention period in days. |

### `snapchat_create_campaign` [#snapchat_create_campaign]

**Snapchat Ads: Create Campaign** · create or change, €29 plan · creates an object on each call

Create a new campaign under an ad account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Campaign name. |
| `status` | `string` | no | Campaign status. Values: `"ACTIVE"`, `"PAUSED"`. Default: `"PAUSED"`. |
| `start_time` | `string` | no | Start time ISO 8601 (e.g. 2025-01-01T00:00:00.000-05:00). |
| `end_time` | `string` | no | End time ISO 8601. |
| `daily_budget_micro` | `number` | no | Daily budget in micro-currency (1 USD = 1000000). |
| `lifetime_spend_cap_micro` | `number` | no | Lifetime spend cap in micro-currency. |
| `objective` | `string` | no | Campaign objective (e.g. AWARENESS, APP\_INSTALLS, WEB\_CONVERSIONS). |

### `snapchat_create_creative` [#snapchat_create_creative]

**Snapchat Ads: Create Creative** · create or change, €29 plan · creates an object on each call

Create a new creative under an ad account. Change it with update\_creative. Snapchat's Marketing API has no endpoint to delete a creative (the Creatives reference lists create, get and update only): create one only if it may stay.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Creative name. |
| `type` | `string` | yes | Creative type. Values: `"SNAP_AD"`, `"APP_INSTALL"`, `"LONGFORM_VIDEO"`, `"WEB_VIEW"`, `"DEEP_LINK"`, `"AD_TO_LENS"`, `"AD_TO_CALL"`, `"AD_TO_MESSAGE"`, `"LENS"`, `"FILTER"`, `"COLLECTION"`, `"LEAD_GENERATION"`. |
| `headline` | `string` | no | Headline text. |
| `brand_name` | `string` | no | Brand name. |
| `shareable` | `boolean` | no | Allow sharing. Default: `true`. |
| `top_snap_media_id` | `string` | no | Top snap media ID. |
| `top_snap_crop_position` | `string` | no | Crop position. Values: `"MIDDLE"`, `"TOP"`, `"BOTTOM"`. |
| `call_to_action` | `string` | no | Call to action. Values: `"BLANK"`, `"WATCH"`, `"VIEW_MORE"`, `"INSTALL_NOW"`, `"SIGN_UP"`, `"SHOP_NOW"`, `"BOOK_NOW"`, `"APPLY_NOW"`, `"GET_NOW"`, `"ORDER_NOW"`, `"LEARN_MORE"`, `"MORE"`, `"LISTEN"`, `"OPEN_APP"`, `"PLAY"`, `"DONATE"`, `"SUBSCRIBE"`, `"DIRECTIONS"`, `"SHOWTIMES"`, `"SEND"`, `"TRY"`, `"USE"`. |
| `web_view_url` | `string` | no | Web view destination URL. |
| `deep_link_uri` | `string` | no | Deep link URI for app. |

### `snapchat_create_media` [#snapchat_create_media]

**Snapchat Ads: Create Media** · create or change, €29 plan · creates an object on each call

Create a media entry (initiate upload) under an ad account. Snapchat's Marketing API has no endpoint to delete or rename a media (the Media reference lists create, upload and get only): create one only if it may stay.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Media name. |
| `type` | `string` | yes | Media type. Values: `"IMAGE"`, `"VIDEO"`, `"LENS_PACKAGE"`. |

### `snapchat_create_pixel` [#snapchat_create_pixel]

**Snapchat Ads: Create Pixel** · create or change, €29 plan · creates an object on each call

Create a new Snapchat pixel named name in the ad account ad\_account\_id. Snapchat's Marketing API has no endpoint to delete a pixel (the Snap Pixel reference lists create, get and update only): create one only if it must stay.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | yes | Pixel name. |

### `snapchat_update_ad` [#snapchat_update_ad]

**Snapchat Ads: Update Ad** · create or change, €29 plan · creates an object on each call

Update an existing ad (Snapchat replaces the whole ad: Pilot reads it first and sends it back with your changes)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | yes | Ad ID. |
| `name` | `string` | no | New name. |
| `status` | `string` | no | New status. Values: `"ACTIVE"`, `"PAUSED"`. |
| `creative_id` | `string` | no | New creative ID. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_update_ad_account` [#snapchat_update_ad_account]

**Snapchat Ads: Update Ad Account** · create or change, €29 plan · creates an object on each call

Update an existing ad account (Snapchat replaces the whole account: Pilot reads it first and sends it back with your changes)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `name` | `string` | no | New name. |
| `advertiser` | `string` | no | New advertiser name. |

### `snapchat_update_ad_squad` [#snapchat_update_ad_squad]

**Snapchat Ads: Update Ad Squad** · create or change, €29 plan · creates an object on each call

Update an existing ad squad (Snapchat replaces the whole ad squad: Pilot reads it first and sends it back with your changes)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_squad_id` | `string` | yes | Ad Squad ID. |
| `name` | `string` | no | New name. |
| `status` | `string` | no | New status. Values: `"ACTIVE"`, `"PAUSED"`. |
| `bid_micro` | `number` | no | New bid in micro-currency. |
| `daily_budget_micro` | `number` | no | New daily budget in micro-currency. |
| `end_time` | `string` | no | New end time ISO 8601. |
| `targeting` | `any` | no | New targeting spec object. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_update_audience` [#snapchat_update_audience]

**Snapchat Ads: Update Audience** · create or change, €29 plan · creates an object on each call

Update an existing audience segment (name, description, retention)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `segment_id` | `string` | yes | Segment ID. |
| `name` | `string` | no | New name. |
| `description` | `string` | no | New description. |
| `retention_in_days` | `number` | no | New retention period. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_update_campaign` [#snapchat_update_campaign]

**Snapchat Ads: Update Campaign** · create or change, €29 plan · creates an object on each call

Update an existing campaign (Snapchat replaces the whole campaign: Pilot reads it first and sends it back with your changes)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes | Campaign ID. |
| `name` | `string` | no | New name. |
| `status` | `string` | no | New status. Values: `"ACTIVE"`, `"PAUSED"`. |
| `daily_budget_micro` | `number` | no | New daily budget in micro-currency. |
| `end_time` | `string` | no | New end time ISO 8601. |
| `lifetime_spend_cap_micro` | `number` | no | New lifetime spend cap in micro-currency. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_update_creative` [#snapchat_update_creative]

**Snapchat Ads: Update Creative** · create or change, €29 plan · creates an object on each call

Update an existing creative (only the given fields change)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `creative_id` | `string` | yes | Creative ID. |
| `name` | `string` | no | New name. |
| `headline` | `string` | no | New headline. |
| `call_to_action` | `string` | no | New CTA. |
| `web_view_url` | `string` | no | New web view URL. |
| `shareable` | `boolean` | no | Allow sharing. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_upload_creative_media` [#snapchat_upload_creative_media]

**Snapchat Ads: Upload Creative Media** · create or change, €29 plan · creates an object on each call

Upload media (image or video) from a URL for use in Snapchat ads. Snapchat's Marketing API has no endpoint to delete or rename a media: upload only what may stay.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_account_id` | `string` | yes | Ad Account ID. |
| `media_url` | `string` | yes | Public URL of the media to upload. |
| `media_type` | `string` | yes | Type of media to upload. Values: `"IMAGE"`, `"VIDEO"`. |
| `name` | `string` | yes | Name for the media asset. |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `snapchat_delete_ad` [#snapchat_delete_ad]

**Snapchat Ads: Delete Ad** · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE ad (irreversible). To stop it instead, use update\_ad with status PAUSED.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | yes | Ad ID. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_delete_ad_squad` [#snapchat_delete_ad_squad]

**Snapchat Ads: Delete Ad Squad** · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE ad squad (irreversible). To stop it instead, use update\_ad\_squad with status PAUSED.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_squad_id` | `string` | yes | Ad Squad ID. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_delete_audience` [#snapchat_delete_audience]

**Snapchat Ads: Delete Audience** · delete, €29 plan, one object at a time · creates an object on each call

Delete one Snapchat audience segment by segment\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `segment_id` | `string` | yes | Segment ID. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |

### `snapchat_delete_campaign` [#snapchat_delete_campaign]

**Snapchat Ads: Delete Campaign** · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE campaign (irreversible). To stop it instead, use update\_campaign with status PAUSED.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes | Campaign ID. |
| `account_id` | `string` | no | Snapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account. |
