The Snapchat Ads connector lets your AI agent act in each user's Snapchat Ads account. Each user signs in to Snapchat Ads once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 27 tools.
- Tools
- 27
- What they doRead · write · destructive
- 18 · 6 · 318 read6 write3 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Snapchat Ads app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Snapchat Ads connection
In AgentKit > Connections, create a Snapchat Ads connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Snapchat Ads connections use your own OAuth app. Register one with Snapchat Ads and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Snapchat Ads connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'snapchatads'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Snapchat Ads:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'snapchatads_me_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "snapchatads"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Snapchat Ads:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="snapchatads_me_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsnapchatads_account_ads_listList every ad in a Snapchat ad account.Read-onlyList Ads in Ad Account
List every ad in a Snapchat ad account. Returns each ad's id, name, status, type, ad_squad_id, creative_id, review_status and delivery_status, plus paging.next_link. Use this for account-wide review, for example ads that were rejected. Use snapchatads_ads_list for one ad squad.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
cursorstring- Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
limitinteger- Number of results per page, 50 to 1000. Example: 100
snapchatads_ad_account_getGet one Snapchat ad account by ID.Read-onlyGet Ad Account
Get one Snapchat ad account by ID. Returns its name, status, currency, timezone, lifetime spend cap and advertiser. Use this to check the currency and time zone before reading stats.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
snapchatads_ad_account_stats_getGet performance stats for a whole Snapchat ad account: impressions, swipes, spend, video views, conversions and other metrics.Read-onlyGet Ad Account Stats
Get performance stats for a whole Snapchat ad account: impressions, swipes, spend, video views, conversions and other metrics. Returns timeseries (DAY or HOUR) or total stats with the requested fields; spend is in micro-currency. Use this to report on performance. Use the other stats tools for other levels.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
granularitystringrequired- Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAYone of
TOTALDAYHOURLIFETIME breakdownstring- Split the results by child entity: campaign, ad. Example: campaignone of
campaignad end_timestring- End of the range (ISO 8601, on the hour). DAY ranges can span up to 31 days, HOUR ranges up to 7 days. Example: 2026-11-15T00:00:00-08:00
fieldsstring- Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
omit_emptyboolean- Leave out rows with no data. Example: true
start_timestring- Start of the range (ISO 8601, on the hour; for DAY at midnight in the ad account's time zone). Example: 2026-11-01T00:00:00-08:00
swipe_up_attribution_windowstring- Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAYone of
1_DAY7_DAY28_DAY view_attribution_windowstring- View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAYone of
none1_HOUR3_HOUR6_HOUR1_DAY7_DAY
snapchatads_ad_accounts_listList the ad accounts of a Snapchat Business organization.Read-onlyList Ad Accounts
List the ad accounts of a Snapchat Business organization. Returns each ad account's id, name, type, status, currency, timezone and funding sources. Use this to find an ad_account_id.
Inputs
organization_idstringrequired- ID of the Snapchat Business organization. Get it from snapchatads_organizations_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
snapchatads_ad_getGet one Snapchat ad by ID.Read-onlyGet Ad
Get one Snapchat ad by ID. Returns its name, status, type, creative_id, review_status, review_status_reasons and delivery_status. Use this to check why an ad is not delivering.
Inputs
ad_idstringrequired- ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
snapchatads_ad_squad_getGet one Snapchat ad squad by ID.Read-onlyGet Ad Squad
Get one Snapchat ad squad by ID. Returns its targeting, placement, bid strategy, optimization goal, budget, schedule and delivery_status. Use this when you know the ad squad ID.
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
snapchatads_ad_squad_stats_getGet performance stats for a Snapchat ad squad: impressions, swipes, spend, video views, conversions and other metrics.Read-onlyGet Ad Squad Stats
Get performance stats for a Snapchat ad squad: impressions, swipes, spend, video views, conversions and other metrics. Returns timeseries (DAY or HOUR) or total stats with the requested fields; spend is in micro-currency. Use this to report on performance. Use the other stats tools for other levels.
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
granularitystringrequired- Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAYone of
TOTALDAYHOURLIFETIME breakdownstring- Split the results by child entity: ad. Example: adone of
ad end_timestring- End of the range (ISO 8601, on the hour). DAY ranges can span up to 31 days, HOUR ranges up to 7 days. Example: 2026-11-15T00:00:00-08:00
fieldsstring- Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
omit_emptyboolean- Leave out rows with no data. Example: true
start_timestring- Start of the range (ISO 8601, on the hour; for DAY at midnight in the ad account's time zone). Example: 2026-11-01T00:00:00-08:00
swipe_up_attribution_windowstring- Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAYone of
1_DAY7_DAY28_DAY view_attribution_windowstring- View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAYone of
none1_HOUR3_HOUR6_HOUR1_DAY7_DAY
snapchatads_ad_squads_listList the ad squads (targeting, budget and bid groups) of a Snapchat campaign.Read-onlyList Ad Squads
List the ad squads (targeting, budget and bid groups) of a Snapchat campaign. Returns each ad squad's id, name, status, type, targeting, optimization_goal, bid and budget, plus paging.next_link. Use this to find an ad_squad_id.
Inputs
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
cursorstring- Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
limitinteger- Number of results per page, 50 to 1000. Example: 100
snapchatads_ad_stats_getGet performance stats for a single Snapchat ad: impressions, swipes, spend, video views, conversions and other metrics.Read-onlyGet Ad Stats
Get performance stats for a single Snapchat ad: impressions, swipes, spend, video views, conversions and other metrics. Returns timeseries (DAY or HOUR) or total stats with the requested fields; spend is in micro-currency. Use this to report on performance. Use the other stats tools for other levels.
Inputs
ad_idstringrequired- ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
granularitystringrequired- Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAYone of
TOTALDAYHOURLIFETIME end_timestring- End of the range (ISO 8601, on the hour). DAY ranges can span up to 31 days, HOUR ranges up to 7 days. Example: 2026-11-15T00:00:00-08:00
fieldsstring- Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
omit_emptyboolean- Leave out rows with no data. Example: true
start_timestring- Start of the range (ISO 8601, on the hour; for DAY at midnight in the ad account's time zone). Example: 2026-11-01T00:00:00-08:00
swipe_up_attribution_windowstring- Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAYone of
1_DAY7_DAY28_DAY view_attribution_windowstring- View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAYone of
none1_HOUR3_HOUR6_HOUR1_DAY7_DAY
snapchatads_ads_listList the ads in a Snapchat ad squad.Read-onlyList Ads in Ad Squad
List the ads in a Snapchat ad squad. Returns each ad's id, name, status, type, creative_id, review_status and delivery_status, plus paging.next_link. Use this for one ad squad. Use snapchatads_account_ads_list for every ad in an account.
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
cursorstring- Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
limitinteger- Number of results per page, 50 to 1000. Example: 100
snapchatads_campaign_getGet one Snapchat campaign by ID.Read-onlyGet Campaign
Get one Snapchat campaign by ID. Returns its name, status, objective, buy model, start and end time, budgets and delivery_status. Use this when you know the campaign ID.
Inputs
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
snapchatads_campaign_stats_getGet performance stats for a Snapchat campaign: impressions, swipes, spend, video views, conversions and other metrics.Read-onlyGet Campaign Stats
Get performance stats for a Snapchat campaign: impressions, swipes, spend, video views, conversions and other metrics. Returns timeseries (DAY or HOUR) or total stats with the requested fields; spend is in micro-currency. Use this to report on performance. Use the other stats tools for other levels.
Inputs
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
granularitystringrequired- Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAYone of
TOTALDAYHOURLIFETIME breakdownstring- Split the results by child entity: adsquad, ad. Example: adsquadone of
adsquadad end_timestring- End of the range (ISO 8601, on the hour). DAY ranges can span up to 31 days, HOUR ranges up to 7 days. Example: 2026-11-15T00:00:00-08:00
fieldsstring- Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
omit_emptyboolean- Leave out rows with no data. Example: true
start_timestring- Start of the range (ISO 8601, on the hour; for DAY at midnight in the ad account's time zone). Example: 2026-11-01T00:00:00-08:00
swipe_up_attribution_windowstring- Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAYone of
1_DAY7_DAY28_DAY view_attribution_windowstring- View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAYone of
none1_HOUR3_HOUR6_HOUR1_DAY7_DAY
snapchatads_campaigns_listList the campaigns in a Snapchat ad account.Read-onlyList Campaigns
List the campaigns in a Snapchat ad account. Returns each campaign's id, name, status, objective, start_time, end_time, budgets and delivery_status, plus paging.next_link. Use this to browse campaigns. Use snapchatads_campaign_get for one campaign.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
cursorstring- Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
limitinteger- Number of results per page, 50 to 1000. Example: 100
sortstring- Sort order: updated_at-desc or created_at-desc. Example: updated_at-descone of
updated_at-desccreated_at-desc
snapchatads_creative_getGet one Snapchat creative by ID.Read-onlyGet Creative
Get one Snapchat creative by ID. Returns its name, type, headline, brand_name, call_to_action, media IDs, attachment properties and review_status. Use this to inspect what an ad shows.
Inputs
creative_idstringrequired- ID of the creative. Example: 9d1b5f6a-1c2d-4e3f-8a9b-0c1d2e3f4a5b
snapchatads_creatives_listList the creatives in a Snapchat ad account.Read-onlyList Creatives
List the creatives in a Snapchat ad account. Returns each creative's id, name, type, headline, brand_name, call_to_action, top_snap_media_id and review_status. Use this to find a creative_id for snapchatads_ad_create.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
cursorstring- Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
limitinteger- Number of results per page, 50 to 1000. Example: 100
typestring- Only creatives of this type, such as SNAP_AD or WEB_VIEW. Example: WEB_VIEW
snapchatads_me_getGet the Snapchat user who authorized the connection.Read-onlyGet Current User
Get the Snapchat user who authorized the connection. Returns the user's id, email, display_name, organization_id and member_status. Use this to learn who is connected and their default organization.
Inputs
This tool takes no inputs.
snapchatads_organization_getGet one Snapchat Business organization by ID.Read-onlyGet Organization
Get one Snapchat Business organization by ID. Returns its name, type, address, country and configuration. Use this when you know the organization ID.
Inputs
organization_idstringrequired- ID of the Snapchat Business organization. Get it from snapchatads_organizations_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
snapchatads_organizations_listList the Snapchat Business organizations the user belongs to, optionally with their ad accounts.Read-onlyList Organizations
List the Snapchat Business organizations the user belongs to, optionally with their ad accounts. Returns each organization's id, name, type and, with with_ad_accounts, its ad accounts and the user's roles. Use this first to find organization and ad account IDs.
Inputs
with_ad_accountsboolean- Also return each organization's ad accounts. Example: true
snapchatads_ad_createCreate an ad in a Snapchat ad squad from an existing creative.WriteCreate Ad
Create an ad in a Snapchat ad squad from an existing creative. Returns the created ad inside ads[0].ad, with its id and review_status. Use this after snapchatads_ad_squad_create; find creative IDs with snapchatads_creatives_list.
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
creative_idstringrequired- ID of the creative to show. Example: 9d1b5f6a-1c2d-4e3f-8a9b-0c1d2e3f4a5b
namestringrequired- Ad name. Example: Holiday sale - video A
statusstringrequired- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED typestringrequired- Ad type, matching the creative: SNAP_AD, REMOTE_WEBPAGE, APP_INSTALL, DEEP_LINK, STORY, COLLECTION, LEAD_GENERATION and others. Example: REMOTE_WEBPAGEone of
SNAP_ADAPP_INSTALLREMOTE_WEBPAGEDEEP_LINKSTORYAD_TO_LENSAD_TO_CALLAD_TO_MESSAGEFILTERLENSLENS_WEB_VIEWLENS_APP_INSTALLLENS_DEEP_LINKCOLLECTIONLEAD_GENERATIONREMINDER
snapchatads_ad_squad_createCreate an ad squad in a Snapchat campaign: who to target, where to show ads, how to bid and how much to spend.WriteCreate Ad Squad
Create an ad squad in a Snapchat campaign: who to target, where to show ads, how to bid and how much to spend. Returns the created ad squad inside adsquads[0].adsquad, with its id. Use this after snapchatads_campaign_create and before snapchatads_ad_create.
Inputs
bid_strategystringrequired- Bidding: AUTO_BID, LOWEST_COST_WITH_MAX_BID or TARGET_COST. Example: AUTO_BIDone of
AUTO_BIDLOWEST_COST_WITH_MAX_BIDTARGET_COST campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
namestringrequired- Ad squad name. Example: US 18-34
optimization_goalstringrequired- What to optimize delivery for, such as IMPRESSIONS, SWIPES, VIDEO_VIEWS, APP_INSTALLS, PIXEL_PURCHASE or LANDING_PAGE_VIEW. Example: SWIPES
statusstringrequired- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED targetingobjectrequired- Targeting spec. regulated_content and geos are the core fields; demographics, interests, devices and segments narrow it further. Country codes are lowercase. Example: {"regulated_content": false, "geos": [{"country_code": "us"}], "demographics": [{"min_age": "18", "max_age": "34"}]}
bid_microinteger- Bid amount (max bid or target cost) for LOWEST_COST_WITH_MAX_BID and TARGET_COST. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 1000000
daily_budget_microinteger- Daily budget, at least 5,000,000. Set this or lifetime_budget_micro. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 20000000
end_timestring- When the ad squad ends (ISO 8601); needed with a lifetime budget. Example: 2026-12-31T23:59:59-08:00
lifetime_budget_microinteger- Lifetime budget, if no daily budget is set. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 500000000
start_timestring- When the ad squad starts (ISO 8601). Example: 2026-12-01T00:00:00-08:00
typestring- Ad squad type: SNAP_ADS, LENS or FILTER. Defaults to SNAP_ADS. Example: SNAP_ADSone of
SNAP_ADSLENSFILTERdefaultSNAP_ADS
snapchatads_ad_squad_updateChange a Snapchat ad squad: pause or activate it, rename it, or change its budget, bid or end time.WriteUpdate Ad Squad
Change a Snapchat ad squad: pause or activate it, rename it, or change its budget, bid or end time. Returns the updated ad squad. Use this to edit one ad squad; only the fields you pass are changed.
- Idempotent
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
bid_microinteger- New bid amount. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 1500000
daily_budget_microinteger- New daily budget, at least 5,000,000. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 30000000
end_timestring- New end time (ISO 8601). Example: 2027-01-07T23:59:59-08:00
namestring- New name. Example: US 18-34 (broad)
statusstring- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED
snapchatads_ad_updatePause, activate or rename a Snapchat ad.WriteUpdate Ad
Pause, activate or rename a Snapchat ad. Returns the updated ad. Use this to edit one ad; only the fields you pass are changed.
- Idempotent
Inputs
ad_idstringrequired- ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
namestring- New ad name. Example: Holiday sale - video B
statusstring- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED
snapchatads_campaign_createCreate a campaign in a Snapchat ad account.WriteCreate Campaign
Create a campaign in a Snapchat ad account. Returns the created campaign inside campaigns[0].campaign, with its id. Use this to start a new campaign; create it PAUSED and add ad squads with snapchatads_ad_squad_create before activating.
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
namestringrequired- Campaign name, up to 375 characters. Example: Holiday sale 2026
start_timestringrequired- When the campaign starts (ISO 8601). Example: 2026-12-01T00:00:00-08:00
statusstringrequired- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED daily_budget_microinteger- Daily budget, at least 20,000,000. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 50000000
end_timestring- When the campaign ends (ISO 8601), after start_time. Example: 2026-12-31T23:59:59-08:00
lifetime_spend_cap_microinteger- Lifetime spend cap, at least 20,000,000. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 1000000000
objective_v2_typestring- Campaign objective: AWARENESS_AND_ENGAGEMENT, SALES, TRAFFIC, APP_PROMOTION or LEADS. Example: SALESone of
AWARENESS_AND_ENGAGEMENTSALESTRAFFICAPP_PROMOTIONLEADS
snapchatads_campaign_updateChange a Snapchat campaign: pause or activate it, rename it, or change its end time or budgets.WriteUpdate Campaign
Change a Snapchat campaign: pause or activate it, rename it, or change its end time or budgets. Returns the updated campaign. Use this to edit one campaign; only the fields you pass are changed.
- Idempotent
Inputs
ad_account_idstringrequired- ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
daily_budget_microinteger- New daily budget, at least 20,000,000. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 75000000
end_timestring- New end time (ISO 8601). Example: 2027-01-07T23:59:59-08:00
lifetime_spend_cap_microinteger- New lifetime spend cap. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 2000000000
namestring- New campaign name. Example: Holiday sale 2026 (extended)
statusstring- Delivery status: ACTIVE or PAUSED. Example: PAUSEDone of
ACTIVEPAUSED
snapchatads_ad_deleteDelete a Snapchat ad.DestructiveDelete Ad
Delete a Snapchat ad. Returns the request status. Use this to remove an ad; use snapchatads_ad_update with status PAUSED to stop it instead.
- Idempotent
Inputs
ad_idstringrequired- ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
snapchatads_ad_squad_deleteDelete a Snapchat ad squad and stop its ads.DestructiveDelete Ad Squad
Delete a Snapchat ad squad and stop its ads. Returns the request status. Use this to remove an ad squad; use snapchatads_ad_squad_update with status PAUSED to stop it instead.
- Idempotent
Inputs
ad_squad_idstringrequired- ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
snapchatads_campaign_deleteDelete a Snapchat campaign.DestructiveDelete Campaign
Delete a Snapchat campaign. Returns the request status. Use this to remove a campaign; use snapchatads_campaign_update with status PAUSED to stop it instead.
- Idempotent
Inputs
campaign_idstringrequired- ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
No tools match.