Saltar para o conteúdo
Tecrübetecrube.com
Assistant tools · Setup and campaigns

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

Leitura1 credits

Snapchat 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

Leitura1 credits

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

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
daysOptionalinteger (1–31)last N whole days, ending yesterday; default 7
statusOptionalactive | paused—

snapchat_performance_report

Leitura1 credits

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

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
daysOptionalinteger (1–31)last N whole days, ending yesterday; default 7
campaign_idOptionalstringlimit the report to one campaign
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD; capped at yesterday
granularityOptionaltotal | daydefault total

diagnose_snapchat_delivery

Leitura1 credits

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

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
campaign_idRequiredstringSnapchat campaign id (list_snapchat_campaigns)

Write tools3 tools

update_snapchat_campaign_status

Escrita2 credits

Pause or activate a Snapchat Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
statusRequiredpause | activate—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_snapchat_campaign_budget

Escrita2 credits

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

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
daily_budgetRequirednumbernew 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

Escrita5 credits

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

ParameterTypeDescription
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
nameRequiredstring—
daily_budgetRequirednumberaccount currency, at least 5
objectiveOptionalBRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES—
optimization_goalOptionalIMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS—
bid_strategyOptionalAUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST—
bidOptionalnumber—
pixel_idOptionalstring—
ad_squad_nameOptionalstring—
start_timeOptionalstringISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z
audienceOptionalobjectcountries, age_min, age_max, genders

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.