Snapchat Ads
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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 18 |
| Create and change (€29) | 15 |
| Delete (€29) | 4 |
Other tools
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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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)
Served with the €29 plan.
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 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 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 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 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 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 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 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 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 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 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 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 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 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 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)
Served with the €29 plan. A deletion targets one object at a time.
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 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 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 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. |