> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Snapchat Ads

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.

**Authentication:** OAuth 2.0
**Categories:** Marketing, Analytics
**Tools:** 27: 18 read, 6 write, 3 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Snapchat Ads app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=SNAPCHATADS)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### 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_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### 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.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'snapchatads'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'snapchatads_me_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "snapchatads"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="snapchatads_me_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'snapchatads_account_ads_list',
  toolInput: {
    ad_account_id: '<ad_account_id>',
  },
  connector: 'snapchatads',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="snapchatads_account_ads_list",
    tool_input={
        "ad_account_id": "<ad_account_id>",
    },
    connection_name="snapchatads",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `snapchatads_account_ads_list`

List Ads in Ad Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `cursor` (`string`, optional): Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
- `limit` (`integer`, optional): Number of results per page, 50 to 1000. Example: 100

Example input: `{"ad_account_id":"<ad_account_id>"}`

### `snapchatads_ad_account_get`

Get Ad Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74

Example input: `{"ad_account_id":"<ad_account_id>"}`

### `snapchatads_ad_account_stats_get`

Get Ad Account Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `granularity` (`string`, required): Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAY. One of: `TOTAL`, `DAY`, `HOUR`, `LIFETIME`.
- `breakdown` (`string`, optional): Split the results by child entity: campaign, ad. Example: campaign. One of: `campaign`, `ad`.
- `end_time` (`string`, optional): 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
- `fields` (`string`, optional): Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
- `omit_empty` (`boolean`, optional): Leave out rows with no data. Example: true
- `start_time` (`string`, optional): 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_window` (`string`, optional): Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAY. One of: `1_DAY`, `7_DAY`, `28_DAY`.
- `view_attribution_window` (`string`, optional): View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAY. One of: `none`, `1_HOUR`, `3_HOUR`, `6_HOUR`, `1_DAY`, `7_DAY`.

Example input: `{"ad_account_id":"<ad_account_id>","granularity":"TOTAL"}`

### `snapchatads_ad_accounts_list`

List Ad Accounts · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `organization_id` (`string`, required): ID of the Snapchat Business organization. Get it from snapchatads_organizations_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74

Example input: `{"organization_id":"<organization_id>"}`

### `snapchatads_ad_get`

Get Ad · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_id` (`string`, required): ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e

Example input: `{"ad_id":"<ad_id>"}`

### `snapchatads_ad_squad_get`

Get Ad Squad · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75

Example input: `{"ad_squad_id":"<ad_squad_id>"}`

### `snapchatads_ad_squad_stats_get`

Get Ad Squad Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
- `granularity` (`string`, required): Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAY. One of: `TOTAL`, `DAY`, `HOUR`, `LIFETIME`.
- `breakdown` (`string`, optional): Split the results by child entity: ad. Example: ad. One of: `ad`.
- `end_time` (`string`, optional): 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
- `fields` (`string`, optional): Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
- `omit_empty` (`boolean`, optional): Leave out rows with no data. Example: true
- `start_time` (`string`, optional): 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_window` (`string`, optional): Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAY. One of: `1_DAY`, `7_DAY`, `28_DAY`.
- `view_attribution_window` (`string`, optional): View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAY. One of: `none`, `1_HOUR`, `3_HOUR`, `6_HOUR`, `1_DAY`, `7_DAY`.

Example input: `{"ad_squad_id":"<ad_squad_id>","granularity":"TOTAL"}`

### `snapchatads_ad_squads_list`

List Ad Squads · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
- `cursor` (`string`, optional): Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
- `limit` (`integer`, optional): Number of results per page, 50 to 1000. Example: 100

Example input: `{"campaign_id":"<campaign_id>"}`

### `snapchatads_ad_stats_get`

Get Ad Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_id` (`string`, required): ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
- `granularity` (`string`, required): Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAY. One of: `TOTAL`, `DAY`, `HOUR`, `LIFETIME`.
- `end_time` (`string`, optional): 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
- `fields` (`string`, optional): Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
- `omit_empty` (`boolean`, optional): Leave out rows with no data. Example: true
- `start_time` (`string`, optional): 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_window` (`string`, optional): Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAY. One of: `1_DAY`, `7_DAY`, `28_DAY`.
- `view_attribution_window` (`string`, optional): View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAY. One of: `none`, `1_HOUR`, `3_HOUR`, `6_HOUR`, `1_DAY`, `7_DAY`.

Example input: `{"ad_id":"<ad_id>","granularity":"TOTAL"}`

### `snapchatads_ads_list`

List Ads in Ad Squad · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
- `cursor` (`string`, optional): Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
- `limit` (`integer`, optional): Number of results per page, 50 to 1000. Example: 100

Example input: `{"ad_squad_id":"<ad_squad_id>"}`

### `snapchatads_campaign_get`

Get Campaign · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3

Example input: `{"campaign_id":"<campaign_id>"}`

### `snapchatads_campaign_stats_get`

Get Campaign Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
- `granularity` (`string`, required): Time grouping: TOTAL, DAY, HOUR or LIFETIME. DAY and HOUR need start_time and end_time. Example: DAY. One of: `TOTAL`, `DAY`, `HOUR`, `LIFETIME`.
- `breakdown` (`string`, optional): Split the results by child entity: adsquad, ad. Example: adsquad. One of: `adsquad`, `ad`.
- `end_time` (`string`, optional): 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
- `fields` (`string`, optional): Comma-separated metrics. Defaults to impressions,spend. Example: impressions,swipes,spend,video_views
- `omit_empty` (`boolean`, optional): Leave out rows with no data. Example: true
- `start_time` (`string`, optional): 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_window` (`string`, optional): Swipe-up attribution window: 1_DAY, 7_DAY or 28_DAY (default). Example: 7_DAY. One of: `1_DAY`, `7_DAY`, `28_DAY`.
- `view_attribution_window` (`string`, optional): View attribution window: none, 1_HOUR, 3_HOUR, 6_HOUR, 1_DAY (default) or 7_DAY. Example: 1_DAY. One of: `none`, `1_HOUR`, `3_HOUR`, `6_HOUR`, `1_DAY`, `7_DAY`.

Example input: `{"campaign_id":"<campaign_id>","granularity":"TOTAL"}`

### `snapchatads_campaigns_list`

List Campaigns · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `cursor` (`string`, optional): Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
- `limit` (`integer`, optional): Number of results per page, 50 to 1000. Example: 100
- `sort` (`string`, optional): Sort order: updated_at-desc or created_at-desc. Example: updated_at-desc. One of: `updated_at-desc`, `created_at-desc`.

Example input: `{"ad_account_id":"<ad_account_id>"}`

### `snapchatads_creative_get`

Get Creative · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `creative_id` (`string`, required): ID of the creative. Example: 9d1b5f6a-1c2d-4e3f-8a9b-0c1d2e3f4a5b

Example input: `{"creative_id":"<creative_id>"}`

### `snapchatads_creatives_list`

List Creatives · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `cursor` (`string`, optional): Cursor for the next page, taken from the cursor parameter of paging.next_link in the previous response. Example: c2Q6MTIzNDU2
- `limit` (`integer`, optional): Number of results per page, 50 to 1000. Example: 100
- `type` (`string`, optional): Only creatives of this type, such as SNAP_AD or WEB_VIEW. Example: WEB_VIEW

Example input: `{"ad_account_id":"<ad_account_id>"}`

### `snapchatads_me_get`

Get Current User · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `snapchatads_organization_get`

Get Organization · Read-only

Get one Snapchat Business organization by ID.
Returns its name, type, address, country and configuration.
Use this when you know the organization ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `organization_id` (`string`, required): ID of the Snapchat Business organization. Get it from snapchatads_organizations_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74

Example input: `{"organization_id":"<organization_id>"}`

### `snapchatads_organizations_list`

List Organizations · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `with_ad_accounts` (`boolean`, optional): Also return each organization's ad accounts. Example: true

Example input: `{}`

### `snapchatads_ad_create`

Create Ad · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
- `creative_id` (`string`, required): ID of the creative to show. Example: 9d1b5f6a-1c2d-4e3f-8a9b-0c1d2e3f4a5b
- `name` (`string`, required): Ad name. Example: Holiday sale - video A
- `status` (`string`, required): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.
- `type` (`string`, required): Ad type, matching the creative: SNAP_AD, REMOTE_WEBPAGE, APP_INSTALL, DEEP_LINK, STORY, COLLECTION, LEAD_GENERATION and others. Example: REMOTE_WEBPAGE. One of: `SNAP_AD`, `APP_INSTALL`, `REMOTE_WEBPAGE`, `DEEP_LINK`, `STORY`, `AD_TO_LENS`, `AD_TO_CALL`, `AD_TO_MESSAGE`, `FILTER`, `LENS`, `LENS_WEB_VIEW`, `LENS_APP_INSTALL`, `LENS_DEEP_LINK`, `COLLECTION`, `LEAD_GENERATION`, `REMINDER`.

Example input: `{"ad_squad_id":"<ad_squad_id>","creative_id":"<creative_id>","name":"<name>","status":"ACTIVE","type":"SNAP_AD"}`

### `snapchatads_ad_squad_create`

Create Ad Squad · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bid_strategy` (`string`, required): Bidding: AUTO_BID, LOWEST_COST_WITH_MAX_BID or TARGET_COST. Example: AUTO_BID. One of: `AUTO_BID`, `LOWEST_COST_WITH_MAX_BID`, `TARGET_COST`.
- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
- `name` (`string`, required): Ad squad name. Example: US 18-34
- `optimization_goal` (`string`, required): What to optimize delivery for, such as IMPRESSIONS, SWIPES, VIDEO_VIEWS, APP_INSTALLS, PIXEL_PURCHASE or LANDING_PAGE_VIEW. Example: SWIPES
- `status` (`string`, required): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.
- `targeting` (`object`, required): 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_micro` (`integer`, optional): 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_micro` (`integer`, optional): 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_time` (`string`, optional): When the ad squad ends (ISO 8601); needed with a lifetime budget. Example: 2026-12-31T23:59:59-08:00
- `lifetime_budget_micro` (`integer`, optional): 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_time` (`string`, optional): When the ad squad starts (ISO 8601). Example: 2026-12-01T00:00:00-08:00
- `type` (`string`, optional): Ad squad type: SNAP_ADS, LENS or FILTER. Defaults to SNAP_ADS. Example: SNAP_ADS. One of: `SNAP_ADS`, `LENS`, `FILTER`. Default: `SNAP_ADS`.

Example input: `{"bid_strategy":"AUTO_BID","campaign_id":"<campaign_id>","name":"<name>","optimization_goal":"<optimization_goal>","status":"ACTIVE","targeting":{}}`

### `snapchatads_ad_squad_update`

Update Ad Squad · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
- `bid_micro` (`integer`, optional): New bid amount. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 1500000
- `daily_budget_micro` (`integer`, optional): 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_time` (`string`, optional): New end time (ISO 8601). Example: 2027-01-07T23:59:59-08:00
- `name` (`string`, optional): New name. Example: US 18-34 (broad)
- `status` (`string`, optional): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.

Example input: `{"ad_squad_id":"<ad_squad_id>","campaign_id":"<campaign_id>"}`

### `snapchatads_ad_update`

Update Ad · Write

Pause, activate or rename a Snapchat ad.
Returns the updated ad.
Use this to edit one ad; only the fields you pass are changed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_id` (`string`, required): ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e
- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75
- `name` (`string`, optional): New ad name. Example: Holiday sale - video B
- `status` (`string`, optional): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.

Example input: `{"ad_id":"<ad_id>","ad_squad_id":"<ad_squad_id>"}`

### `snapchatads_campaign_create`

Create Campaign · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `name` (`string`, required): Campaign name, up to 375 characters. Example: Holiday sale 2026
- `start_time` (`string`, required): When the campaign starts (ISO 8601). Example: 2026-12-01T00:00:00-08:00
- `status` (`string`, required): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.
- `daily_budget_micro` (`integer`, optional): 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_time` (`string`, optional): When the campaign ends (ISO 8601), after start_time. Example: 2026-12-31T23:59:59-08:00
- `lifetime_spend_cap_micro` (`integer`, optional): 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_type` (`string`, optional): Campaign objective: AWARENESS_AND_ENGAGEMENT, SALES, TRAFFIC, APP_PROMOTION or LEADS. Example: SALES. One of: `AWARENESS_AND_ENGAGEMENT`, `SALES`, `TRAFFIC`, `APP_PROMOTION`, `LEADS`.

Example input: `{"ad_account_id":"<ad_account_id>","name":"<name>","start_time":"<start_time>","status":"ACTIVE"}`

### `snapchatads_campaign_update`

Update Campaign · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ad_account_id` (`string`, required): ID of the ad account. Get it from snapchatads_ad_accounts_list. Example: 8adc3db7-8148-4fbf-999c-8d2266369d74
- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3
- `daily_budget_micro` (`integer`, optional): 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_time` (`string`, optional): New end time (ISO 8601). Example: 2027-01-07T23:59:59-08:00
- `lifetime_spend_cap_micro` (`integer`, optional): New lifetime spend cap. Amounts are in micro-currency: 1 unit of the account currency is 1,000,000. Example: 2000000000
- `name` (`string`, optional): New campaign name. Example: Holiday sale 2026 (extended)
- `status` (`string`, optional): Delivery status: ACTIVE or PAUSED. Example: PAUSED. One of: `ACTIVE`, `PAUSED`.

Example input: `{"ad_account_id":"<ad_account_id>","campaign_id":"<campaign_id>"}`

### `snapchatads_ad_delete`

Delete Ad · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ad_id` (`string`, required): ID of the ad. Get it from snapchatads_ads_list. Example: 7e1d0e2b-9f3a-4c5e-8b1d-2f9b8c7a6d5e

Example input: `{"ad_id":"<ad_id>"}`

### `snapchatads_ad_squad_delete`

Delete Ad Squad · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ad_squad_id` (`string`, required): ID of the ad squad. Get it from snapchatads_ad_squads_list. Example: 23ac4ad3-1cde-4e32-9df5-5a3d6e8e6d75

Example input: `{"ad_squad_id":"<ad_squad_id>"}`

### `snapchatads_campaign_delete`

Delete Campaign · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Get it from snapchatads_campaigns_list. Example: 6cf25572-048b-4447-95d1-eb47032fe4f3

Example input: `{"campaign_id":"<campaign_id>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
