Snapchat Ads

Snapchat Ads

This connector works with Snapchat advertising through the Snapchat Marketing API (https://adsapi.snapchat.com/v1), signed in as one Snapchat Business user: organizations and ad accounts, campaigns, ad squads (ad sets), ads, creatives, audience segments and performance statistics. It can pause a campaign or turn it back on. It signs in with OAuth 2.0 (authorization code) through an OAuth app of your own in Snap Business Manager. The Marketing API is open to every advertiser: no application or review by Snap is needed.

Setup (about 10 minutes)

1. Sign in at https://business.snapchat.com as an Organization Admin (only admins see the OAuth app settings).
2. Open Business Details (or Business Settings) → OAuth Apps → create an app. Give it a name and set the Redirect URI to https://cloud.anythingmcp.com/api/mcp-oauth/callback on AnythingMCP Cloud, or <your AnythingMCP URL>/api/mcp-oauth/callback when you host AnythingMCP yourself. Accept the Snap Developer Terms and Snap Business Tools Terms.
3. Copy the Client ID into SNAPCHAT_CLIENT_ID and the Client Secret into SNAPCHAT_CLIENT_SECRET. The secret is shown only once; if it is lost, create a new app.
4. Install the connector, click Authorize with Provider, sign in with the Snapchat account that has access to the ad accounts and approve.

Scope requested: snapchat-marketing-api. The connector sees what the authorizing user may see in Ads Manager; ad accounts that user has no role on answer 403.

Start here: snapchat_list_organizations lists the organizations with their ad accounts (ids, currency, time zone). Then snapchat_list_campaigns → snapchat_list_ad_squads → snapchat_list_ads, and snapchat_get_stats for numbers.

Money is in micro-currency: budgets, bids, spend caps and the spend metric are the amount times 1,000,000 in the ad account's currency (spend: 12345678 is 12.35). Always convert before quoting.

Statistics (snapchat_get_stats): entity_type adaccounts, campaigns, adsquads or ads, plus its id. granularity TOTAL (default) or LIFETIME for one sum, DAY (at most 31 days) or HOUR (at most 7 days) for a series. DAY and HOUR need start_time and end_time on whole hours; for DAY on midnight in the ad account's time zone, e.g. 2026-10-01T00:00:00 to 2026-10-08T00:00:00. breakdown splits by child entity (campaign on an ad account, adsquad on a campaign, ad on either). Default metrics are impressions, swipes and spend. Very large requests answer 400 E9001: ask for fewer fields or a shorter period. Figures become final 48 hours after the end of a day.

Changes spend money: confirm first. snapchat_set_campaign_status with ACTIVE starts spending, PAUSED stops delivery. Say which campaign and what will happen, and wait for the user's yes. It changes only the status (a JSON Patch); Snapchat re-checks the whole campaign and refuses invalid ones (sub_request_error_reason). snapchat_set_campaign_daily_budget is installed switched off.

Tools: snapchat_get_me, snapchat_list_organizations, snapchat_list_ad_accounts, snapchat_get_ad_account, snapchat_list_campaigns, snapchat_get_campaign, snapchat_list_ad_squads, snapchat_get_ad_squad, snapchat_list_ads, snapchat_get_ad, snapchat_list_creatives, snapchat_get_creative, snapchat_get_stats, snapchat_list_audiences (read); snapchat_set_campaign_status (change, confirm first); snapchat_set_campaign_daily_budget (switched off).

Paging: list tools take limit (50 to 1000, default 50) and return next_link while more exist; pass the cursor= value from that link as cursor. Answers wrap each entity with a sub_request_status; the connector unwraps them.

Sign-in lifetime: access tokens last one hour and are renewed automatically with the refresh token. Removing the user from the organization, or the app, ends the sign-in; then click Authorize with Provider again.

Errors

• 401 "unauthorized": the sign-in expired or was revoked; authorize again. Snapchat checks the token before the address, so a wrong id also shows as 401 when the token is bad.
• 403: the user has no role on that organization or ad account.
• 400 with request_status: ERROR and a display_message or sub_request_error_reason (e.g. E1165 or E1166 for a refused patch): read the message; it names the field.
• 429: too many requests; wait and try again.

Out of scope: creating or deleting campaigns, ad squads, ads and creatives, uploading media, targeting changes, the Conversions API, Public Profile API, pixels, billing and invoices, and asynchronous CSV reports.