Snapchat tools
Snapchat ad accounts, campaigns and performance reports; status and daily budget changes go through preview and approval and can be undone.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools4 tools
list_snapchat_ad_accounts
读取1 creditsSnapchat Ads accounts reachable through the connected login, across its organizations: account_id, name, currency, time zone, status, organization and which one is selected. Read only; connected=false when Snapchat isn't connected.
This tool takes no parameters.
list_snapchat_campaigns
读取1 creditsSnapchat Ads campaigns of the account: id, name, status, objective, daily budget and lifetime spend cap (account currency), schedule, delivery status, plus spend, impressions, swipes and purchase conversions for the last N whole days. Read only; never invents numbers (stats=null when Snapchat returned none).
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
daysOptional | integer (1–31) | last N whole days, ending yesterday; default 7 |
statusOptional | active | paused | — |
snapchat_performance_report
读取1 creditsSnapchat Ads performance for up to 31 whole days in the account time zone: totals, a per-campaign breakdown and optional daily rows with spend, impressions, swipes, purchases, purchase value and add-to-cart. Today isn't included. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
daysOptional | integer (1–31) | last N whole days, ending yesterday; default 7 |
campaign_idOptional | string | limit the report to one campaign |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD; capped at yesterday |
granularityOptional | total | day | default total |
diagnose_snapchat_delivery
读取1 creditsWhy a Snapchat Ads campaign isn't delivering, or is paused, pending, limited or rejected: call it first when the user reports such a problem. Live read of the ad account, the campaign, its ad squads (delivery status codes, budget, bid strategy, bid, ROAS value, pacing) and ads (review status and rejection reasons), plus the campaign's change log and Snap's bid estimate; returned with a findings list (scope, Snap's code, category, evidence) and cannot_read for what wasn't read. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
campaign_idRequired | string | Snapchat campaign id (list_snapchat_campaigns) |
Write tools3 tools
update_snapchat_campaign_status
写入2 creditsPause or activate a Snapchat Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
statusRequired | pause | activate | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_snapchat_campaign_budget
写入2 creditsSet a Snapchat Ads campaign daily budget (account currency, minimum 20). Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action when the campaign already had a daily budget.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
daily_budgetRequired | number | new daily budget in the account currency, at least 20 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_snapchat_campaign
写入5 creditsCreate a Snapchat campaign together with its ad squad (targeting, budget, optimisation goal, bid strategy) - both paused. An ad needs a creative uploaded to Snapchat first, so it is not created here. Applied when the user asks; activate it with update_snapchat_campaign_status.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
nameRequired | string | — |
daily_budgetRequired | number | account currency, at least 5 |
objectiveOptional | BRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES | — |
optimization_goalOptional | IMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS | — |
bid_strategyOptional | AUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST | — |
bidOptional | number | — |
pixel_idOptional | string | — |
ad_squad_nameOptional | string | — |
start_timeOptional | string | ISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z |
audienceOptional | object | countries, age_min, age_max, genders |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.