# Snapchat

```json
{
  "name": "Snapchat",
  "slug": "snapchat",
  "url": "https://composio.dev/toolkits/snapchat",
  "markdown_url": "https://composio.dev/toolkits/snapchat.md",
  "logo_url": "https://logos.composio.dev/api/snapchat",
  "categories": [
    "advertising & marketing"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-06-18T10:08:51.070Z"
}
```

![Snapchat logo](https://logos.composio.dev/api/snapchat)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Snapchat MCP or direct API to create ad campaigns, manage ad accounts, analyze performance metrics, and access business data through natural language.

## Summary

Snapchat is a multimedia messaging and social platform with camera-first content, Stories, and Ads Manager.
It helps brands reach mobile audiences with visual ads and measurable campaign performance.

## Categories

- advertising & marketing

## Toolkit Details

- Tools: 139

## Images

- Logo: https://logos.composio.dev/api/snapchat

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Snapchat.
  - Setup:
    - Configure Oauth2 credentials for Snapchat.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List Snapchat ad accounts I manage
- Create Snapchat campaign for spring sale
- Summarize Snapchat ads performance this week

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `SNAPCHAT_ADD_SEGMENT_USERS` | Add Users to Segment | Tool to add users to a Snapchat audience segment. Use when you need to populate a segment with user identifiers (email, phone, or mobile ad IDs). All identifiers must be normalized and SHA-256 hashed before submission. Maximum 100,000 identifiers per request. |
| `SNAPCHAT_COPY_MEDIA` | Copy Media Between Ad Accounts | Copies media from one Snapchat ad account to another. Use this when you need to duplicate media assets (images, videos) across different ad accounts for campaign management or sharing creative assets. |
| `SNAPCHAT_CREATE_ACCOUNT_ROLE` | Create Account Role | Tool to create new roles for members in a Snapchat Ad Account. Use when you need to grant access permissions to members. Note: Member must already have an Organization-level 'member' role before assigning Ad Account roles. |
| `SNAPCHAT_CREATE_AD_ACCOUNT` | Create Ad Account | Tool to create a new ad account within a Snapchat organization. Use when setting up a new advertising account for campaign management. Requires organization_id, billing center, and advertiser details. Can create test accounts for development purposes. |
| `SNAPCHAT_CREATE_ADACCOUNTS_AUDIENCE_SIZE_V2` | Estimate Ad Account Audience Size | Tool to estimate audience size for Snapchat ad campaigns. Use when you need to determine potential reach for specific targeting criteria before creating ad campaigns. |
| `SNAPCHAT_CREATE_ADACCOUNTS_CREATIVE_ELEMENTS` | Create ad account creative elements | Tool to create new creative elements in a Snapchat ad account. Use when you need to create dynamic ad elements like buttons for product catalogs or dynamic collections. Once created, creative elements cannot be updated and are immutable. |
| `SNAPCHAT_CREATE_ADACCOUNTS_DYNAMIC_TEMPLATES` | Create Ad Account Dynamic Templates | Tool to create new dynamic templates for product ads in a Snapchat ad account. Use when you need to set up templates that define how product information from a catalog will be displayed in dynamic product ads. |
| `SNAPCHAT_CREATE_ADACCOUNTS_EVENT_DETAILS` | Create Ad Account Event Details | Tool to create event details for a Snapchat ad account. Use when scheduling advertising events or campaigns. Event details are immutable after creation and cannot be edited. Ensure the event is not referenced by active Reminder Creatives before deletion. |
| `SNAPCHAT_CREATE_ADACCOUNTS_INTERACTION_ZONES` | Create Ad Account Interaction Zones | Create new interaction zones for an ad account in Snapchat Marketing API. Interaction zones are used for dynamic collections ads and contain 2-4 creative elements with matching interaction types. |
| `SNAPCHAT_CREATE_ADACCOUNTS_OFFER_DISCLAIMERS` | Create Offer Disclaimers | Tool to create new offer disclaimers for a Snapchat ad account. Use when you need to add legal disclaimers to offers in ads. STATIC disclaimers display custom text directly, while DYNAMIC disclaimers pull content from product catalogs. |
| `SNAPCHAT_CREATE_ADACCOUNTS_RESERVED_FORECASTING` | Create ad account reserved forecasting | Tool to create a reserved forecasting for Snapchat ad accounts. Use when you need to forecast reach and frequency for planned campaigns with specific targeting and frequency caps. Requires minimum reach of 500,000 unique users and booking window between 12 hours and 365 days. |
| `SNAPCHAT_CREATE_ADACCOUNTS_TARGETING_INSIGHTS` | Create Adaccounts Targeting Insights | Tool to generate targeting insights for a Snapchat ad account. Use when you need to analyze and compare audience demographics, size, and characteristics between a base targeting spec and a target targeting spec. Returns detailed breakdowns including age groups, gender, languages, geographic distribution, and audience size estimates. |
| `SNAPCHAT_CREATE_AD_SQUAD` | Create Ad Squad | Tool to create a new ad squad within a campaign. Use when setting up ad delivery targeting, budgets, and placements for a Snapchat campaign. |
| `SNAPCHAT_CREATE_BILLING_CENTER` | Create Billing Center | Tool to create one or more billing centers for a Snapchat Ads organization. Use when you need to set up new billing entities for managing ad spend and invoicing. Requires organization ID, billing center name, email address, and complete billing address information. |
| `SNAPCHAT_CREATE_CAMPAIGN` | Create Campaign | Tool to create a new advertising campaign in Snapchat Marketing API. Use when you need to set up a new campaign with specified budget, timing, and objectives. |
| `SNAPCHAT_CREATE_CATALOG_ROLE` | Create Catalog Role | Tool to create new roles for a catalog in Snapchat Marketing API. Use when you need to assign catalog permissions to members. Members must already have the 'member' organizational role before receiving catalog roles. |
| `SNAPCHAT_CREATE_CATALOGS_FACETS` | Create Catalog Facets | Tool to create catalog facets for grouping products by attributes like BRAND, COLOR, or AVAILABILITY. Use when you need to analyze product distribution across different attributes in a catalog. Returns grouped counts for specified product properties with optional filtering support. |
| `SNAPCHAT_CREATE_CATALOGS_FLIGHTS_SEARCH` | Search Catalog Flights | Tool to search for flights within a Snapchat catalog using optional filters. Use when you need to retrieve and filter flight listings from a dynamic product ads catalog. |
| `SNAPCHAT_CREATE_CATALOGS_PRODUCT_FEEDS` | Create Catalogs Product Feed | Tool to create a new product feed under a specified catalog. Use when setting up product data synchronization for dynamic product ads. Note: Currently only one product feed can exist per catalog. |
| `SNAPCHAT_CREATE_CATALOGS_PRODUCT_SETS` | Create Catalog Product Set | Tool to create a new product set within a Snapchat catalog. Use when you need to define product groups using filters for dynamic product ads. |
| `SNAPCHAT_CREATE_MEDIA` | Create Media | Tool to create a new media file in a Snapchat ad account. Use when you need to register media assets (images, videos, lenses, or playable ads) before uploading content or associating with ad creatives. |
| `SNAPCHAT_CREATE_ORGANIZATIONS_CATALOGS` | Create Organizations Catalogs | Tool to create new product catalogs within a Snapchat organization for Dynamic Product Ads. Use when you need to set up catalogs for automated ad generation based on product data feeds. Requires Organization Admin permission. Maximum 200 catalogs per organization, 10 per batch. |
| `SNAPCHAT_CREATE_ORG_ROLE` | Create Organization Role | Tool to create a new role for an organization in Snapchat Marketing API. Use when you need to assign roles to organization members after they have been invited. Each member must be assigned one organization-level role type. |
| `SNAPCHAT_CREATE_SEGMENT` | Create Audience Segment | Tool to create new audience segments (customer lists or lookalikes) in Snapchat Ads. Use when you need to create targeted audience segments for ad campaigns. Initial status returns as PENDING and transitions occur after processing. Note: An ad account can only have a maximum of 1000 customer list segments. |
| `SNAPCHAT_DELETE_ADACCOUNTS_OFFER_DISCLAIMERS` | Delete Offer Disclaimer | Tool to delete an offer disclaimer from a Snapchat ad account. Use when you need to remove an offer disclaimer that is no longer needed or was created in error. |
| `SNAPCHAT_DELETE_ADSQUADS` | Delete Ad Squad | Tool to permanently delete an ad squad from Snapchat Marketing API. Use when you need to remove an ad squad that is no longer needed. This operation cannot be undone. |
| `SNAPCHAT_DELETE_ALL_SEGMENT_USERS` | Delete All Segment Users | Tool to remove all users from a Snapchat audience segment. Use when you need to clear all users from a Customer List segment. Returns the updated segment with approximate_number_users set to 0. |
| `SNAPCHAT_DELETE_CAMPAIGN` | Delete Campaign | Tool to delete a campaign from Snapchat Marketing API. Use when you need to permanently remove a campaign from your Snapchat Ads account. |
| `SNAPCHAT_DELETE_CATALOGS` | Delete Catalog | Tool to delete a catalog by ID from Snapchat Marketing API. Use when you need to permanently remove a catalog. This is a destructive operation that cannot be undone. |
| `SNAPCHAT_DELETE_EVENT_DETAILS` | Delete Event Details | Tool to delete event details from Snapchat Marketing API. Use when you need to remove an Event Details entity. Use with caution as there is no way to reinstate a deleted entity. |
| `SNAPCHAT_DELETE_MEMBER` | Delete Member | Tool to remove a member from an organization in Snapchat Marketing API. Use when you need to revoke access for a member. |
| `SNAPCHAT_DELETE_PRODUCT_FEEDS` | Delete product feed | Tool to permanently delete a product feed from Snapchat Ads. Use when you need to remove a product catalog feed. Requires Organization Admin permission. This action is irreversible. |
| `SNAPCHAT_DELETE_ROLE` | Delete Role | Tool to delete a role from Snapchat Marketing API. Use when you need to remove a role from an Organisation, Catalog or Ad Account. If deleting all of a Member's roles, consider also deleting the Member entity from the Organization. |
| `SNAPCHAT_DELETE_SEGMENT` | Delete Audience Segment | Tool to delete an audience segment from Snapchat. Use when you need to permanently remove an audience segment. WARNING: This operation is irreversible - deleted segments cannot be retrieved. |
| `SNAPCHAT_DELETE_SEGMENT_USERS` | Delete Users from Segment | Tool to remove specific users from a Snapchat audience segment. Use when you need to delete certain user identifiers (email, phone, or mobile ad IDs) from a Customer List segment. All identifiers must be normalized and SHA-256 hashed before submission. Maximum 100,000 identifiers per request. |
| `SNAPCHAT_GET_AD_ACCOUNT` | Get Ad Account | Tool to retrieve a specific ad account by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing ad account. |
| `SNAPCHAT_GET_ADACCOUNTS_ADSQUADS` | Get Ad Account Ad Squads | Tool to retrieve all ad squads in an ad account by ID. Use when you need to list or fetch ad squads for a specific Snapchat ad account. |
| `SNAPCHAT_GET_ADACCOUNTS_AD_SQUAD_UI_RENDER_DATA` | Get Ad Account Ad Squad UI Render Data | Tool to retrieve ad squad UI render data for a Snapchat ad account. Use when you need to fetch UI render data objects that determine available optimization goals together with campaign objectives. The conversion_location field indicates where conversions occur (APP, CALL, LEAD_FORM, PUBLIC_PROFILE, TEXT, or WEB). |
| `SNAPCHAT_GET_ADACCOUNTS_DYNAMIC_TEMPLATES` | Get Ad Account Dynamic Templates | Tool to retrieve dynamic templates for a Snapchat ad account. Use when you need to list or fetch dynamic templates used for dynamic product ads in a specific ad account. |
| `SNAPCHAT_GET_ADACCOUNTS_EVENT_DETAILS` | Get Ad Account Event Details | Tool to retrieve all Event Details entities for a specific ad account. Use when you need to list event details associated with an ad account for reminder creative campaigns. |
| `SNAPCHAT_GET_ADACCOUNTS_INTERACTION_ZONES` | Get Ad Account Interaction Zones | Tool to retrieve interaction zones for an ad account from Snapchat Marketing API. Use when you need to list all interaction zones configured for a specific ad account. |
| `SNAPCHAT_GET_AD_ACCOUNTS_LEAD_GENERATION_FORMS` | Get Ad Account Lead Generation Forms | Tool to retrieve all lead generation forms for a specific ad account from Snapchat Marketing API. Use when you need to list or fetch all lead gen forms associated with an advertising account. |
| `SNAPCHAT_GET_ADACCOUNTS_LEADS_REPORT` | Get Ad Account Leads Report | Tool to retrieve ad account leads report by ID from Snapchat Marketing API. Use when you need to fetch lead generation data for a specific ad account and report run. |
| `SNAPCHAT_GET_ADACCOUNTS_MOBILE_APPS` | Get Ad Account Mobile Apps | Tool to retrieve all mobile apps associated with a Snapchat ad account by ID. Use when you need to list or fetch mobile apps for a specific ad account. |
| `SNAPCHAT_GET_ADACCOUNTS_OFFER_DISCLAIMERS` | Get Ad Account Offer Disclaimers | Tool to retrieve all offer disclaimers for a specific ad account from Snapchat Marketing API. Use when you need to list or fetch legal disclaimers associated with an advertising account's offers. |
| `SNAPCHAT_GET_ADACCOUNTS_SPEND_GUIDANCE` | Get Ad Account Spend Guidance | Tool to retrieve spend guidance for an ad account from Snapchat Marketing API. Use when you need bid and budget recommendations for specific signal types and optimization goals. |
| `SNAPCHAT_GET_AD_ACCOUNTS_STATS` | Get Ad Account Stats | Tool to retrieve ad account statistics from Snapchat Marketing API. Use when you need performance metrics like impressions, swipes, spend, or video views for an ad account over a specified time period. |
| `SNAPCHAT_GET_ADACCOUNTS_STATS_REPORT` | Get Ad Account Stats Report | Tool to retrieve ad account stats report by ID from Snapchat Marketing API. Use when you need to check the status of an async stats report or download a completed report. |
| `SNAPCHAT_GET_AD_SQUAD` | Get Ad Squad | Tool to retrieve a specific ad squad by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing ad squad including targeting, budget, and placement settings. |
| `SNAPCHAT_GET_AD_SQUAD_RESTRICTIONS` | Get Ad Squad Restrictions | Tool to retrieve ad type restrictions for a specific ad squad from Snapchat Marketing API. Use when you need to see which ad types are currently present in an ad squad and their counts. |
| `SNAPCHAT_GET_ADSQUADS_AUDIENCE_SIZE_V2` | Get Ad Squad Audience Size | Tool to retrieve estimated audience size for a specific ad squad by ID. Use when you need to check the potential reach of an existing ad squad's targeting configuration. |
| `SNAPCHAT_GET_ADSQUADS_STATS_REPORT` | Get Ad Squad Stats Report | Tool to retrieve adsquads stats report by ID from Snapchat Marketing API. Use when checking the status of an async report or getting the download URL for a completed stats report. |
| `SNAPCHAT_GET_AD_SQUAD_STATS` | Get Ad Squad Stats | Tool to retrieve performance statistics for a specific ad squad from Snapchat Marketing API. Use when you need to analyze ad squad performance metrics such as impressions, swipes, conversions, and spend. |
| `SNAPCHAT_GET_AD_SQUAD_TARGETING` | Get Ad Squad Targeting | Tool to retrieve targeting specifications for a specific ad squad from Snapchat Marketing API. Use when you need to fetch detailed targeting criteria for an existing ad squad. |
| `SNAPCHAT_GET_AD_STATS` | Get Ad Stats | Tool to retrieve performance statistics for a specific ad from Snapchat Marketing API. Use when you need to analyze ad performance metrics such as impressions, swipes, conversions, and spend. |
| `SNAPCHAT_GET_AUTHENTICATED_USER` | Get Authenticated User | Tool to retrieve information about the authenticated user from Snapchat Marketing API. Use when you need to fetch the current user's ID, email, display name, organization membership, or Snapchat username. |
| `SNAPCHAT_GET_BILLING_CENTER` | Get Billing Center | Tool to retrieve a specific billing center by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing billing center. |
| `SNAPCHAT_GET_CAMPAIGN` | Get Campaign | Tool to retrieve a specific campaign by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing campaign. |
| `SNAPCHAT_GET_CAMPAIGN_CHANGELOG` | Get Campaign Changelog | Tool to retrieve changelog (audit log) for a campaign from Snapchat Marketing API. Use when you need to track changes made to a campaign, including who made the changes and what was modified. Note: changelogs are only available from July 16, 2019 onwards. |
| `SNAPCHAT_GET_CAMPAIGNS_BY_IDS` | Get Campaigns by IDs | Tool to fetch multiple campaigns by their IDs from Snapchat Marketing API. Use when you need to retrieve detailed information about specific campaigns in bulk. |
| `SNAPCHAT_GET_CAMPAIGN_STATS` | Get Campaign Stats | Tool to retrieve performance statistics for a specific campaign from Snapchat Marketing API. Use when you need to analyze campaign performance metrics such as impressions, swipes, conversions, and spend. |
| `SNAPCHAT_GET_CATALOGS` | Get Catalog | Tool to retrieve a specific catalog by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing catalog including its vertical, event sources, and product set details. |
| `SNAPCHAT_GET_CATALOGS_PRODUCT_SETS` | Get Catalog Product Sets | Tool to retrieve all product sets from a Snapchat catalog. Use when you need to list or view product sets within a specific catalog for dynamic product ads. |
| `SNAPCHAT_GET_DYNAMIC_TEMPLATE` | Get Dynamic Template | Tool to retrieve a specific dynamic template by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing dynamic template used for dynamic product ads. |
| `SNAPCHAT_GET_DYNAMIC_TEMPLATES_EXTERNAL_CHANGELOGS` | Get Dynamic Templates External Changelogs | Tool to retrieve external changelogs for a dynamic template from Snapchat Marketing API. Use when you need to track modification history and audit changes made to a dynamic template. Note: changelogs are only available from July 16, 2019 onwards. |
| `SNAPCHAT_GET_EVENT_DETAILS` | Get Event Details | Tool to retrieve event details by ID from Snapchat Marketing API. Use when you need to fetch detailed information about a specific event. |
| `SNAPCHAT_GET_FUNDING_SOURCE` | Get Funding Source | Tool to retrieve a specific funding source by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about payment methods like credit cards, PayPal accounts, or lines of credit. |
| `SNAPCHAT_GET_INTERACTION_ZONE` | Get Interaction Zone | Tool to retrieve a specific interaction zone by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing interaction zone including its creative elements and render type. |
| `SNAPCHAT_GET_INVOICE` | Get Invoice | Tool to retrieve a specific invoice by its ID from Snapchat Marketing API. Use when you need to fetch detailed billing information including amounts, due dates, and optionally PDF content for a specific invoice. |
| `SNAPCHAT_GET_MEDIA` | Get Media | Tool to retrieve a specific media file by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing media asset. |
| `SNAPCHAT_GET_MEDIA_BY_IDS` | Get Media by IDs | Tool to fetch multiple media items by their IDs from Snapchat Marketing API. Use when you need to retrieve detailed information about specific media assets in bulk. |
| `SNAPCHAT_GET_MEDIA_STATS` | Get Media Stats | Tool to retrieve performance statistics for a specific media from Snapchat Marketing API. Use when you need to analyze media performance metrics such as impressions, swipes, spend, and video views. Supports VIDEO and IMAGE media types only; reach metrics are not available. |
| `SNAPCHAT_GET_MEMBER` | Get Member | Tool to retrieve a specific member by ID from a Snapchat organization. Use when you need to fetch detailed information about an existing member. |
| `SNAPCHAT_GET_ORGANIZATION` | Get Organization | Tool to retrieve a specific organization by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing organization. |
| `SNAPCHAT_GET_ORGANIZATIONS_CATALOGS` | Get Organizations Catalogs | Tool to retrieve all catalogs for a specific organization from Snapchat Marketing API. Use when you need to list all catalogs within an organization for Dynamic Product Ads. Supports pagination for large result sets. |
| `SNAPCHAT_GET_ORGANIZATIONS_MOBILE_APPS` | Get Organizations Mobile Apps | Tool to retrieve mobile apps associated with a Snapchat organization by organization ID. Use when you need to list iOS and Android apps registered for tracking and campaigns. |
| `SNAPCHAT_GET_ORGANIZATIONS_PUBLIC_PROFILES` | Get Organizations Public Profiles | Tool to retrieve organization public profiles by ID from Snapchat Marketing API. Use when you need to fetch public profile information for a specific organization. |
| `SNAPCHAT_GET_PIXELS` | Get Ad Account Pixels | Tool to retrieve all Snap Pixels associated with an ad account. Use when you need to list conversion tracking pixels for a specific Snapchat ad account. |
| `SNAPCHAT_GET_PRODUCT_FEEDS` | Get Product Feed | Tool to retrieve a product feed by ID from Snapchat Marketing API. Use when you need to get details about a specific product feed including its configuration, schedule, and metadata for dynamic product ads. |
| `SNAPCHAT_GET_PRODUCT_FEEDS_FEED_UPLOADS` | Get Product Feed Uploads | Tool to retrieve product feed upload history for a specific product feed. Use when you need to check the status, metrics, or processing details of product catalog uploads for dynamic product ads. |
| `SNAPCHAT_GET_PRODUCT_SETS` | Get Product Set | Tool to retrieve a specific product set by ID from Snapchat Marketing API. Use when you need to fetch details about a particular product set for dynamic product ads. |
| `SNAPCHAT_GET_SEGMENT` | Get Audience Segment | Tool to retrieve a specific audience segment by its ID from Snapchat Marketing API. Use when you need to fetch detailed information about an existing segment including its status, size, and targeting availability. |
| `SNAPCHAT_GET_TARGETING_CARRIERS` | Get Targeting Carriers | Tool to retrieve available mobile carrier targeting options from Snapchat Marketing API. Use when you need to get the list of carriers that can be used for ad targeting. |
| `SNAPCHAT_GET_TARGETING_CONNECTION_TYPES` | Get Targeting Connection Types | Tool to retrieve available connection types for device targeting from Snapchat Marketing API. Use when you need to fetch the list of connection type options (WIFI, CELL) that can be used for ad targeting. |
| `SNAPCHAT_GET_TARGETING_DEMOGRAPHICS_ADVANCED_DEMOGRAPHICS` | Get Advanced Demographics Targeting Options | Tool to retrieve all available advanced demographics targeting options from Snapchat Marketing API. Use when you need to fetch the list of demographic segments available for ad targeting. |
| `SNAPCHAT_GET_TARGETING_DEMOGRAPHICS_AGE_GROUP` | Get Targeting Demographics Age Group | Tool to retrieve all available age group targeting options from Snapchat Marketing API. Use when you need to fetch the predefined age brackets (13-17, 18-20, 21-24, 25-34, 35+) for demographic targeting in ad campaigns. |
| `SNAPCHAT_GET_TARGETING_DEMOGRAPHICS_GENDER` | Get Gender Targeting Options | Tool to retrieve all available gender targeting options from Snapchat Marketing API. Use when you need to fetch the list of gender categories available for ad targeting (MALE, FEMALE, OTHER). |
| `SNAPCHAT_GET_TARGETING_DEMOGRAPHICS_LANGUAGES` | Get Targeting Demographics Languages | Tool to retrieve all available language targeting options from Snapchat Marketing API. Use when you need to fetch language codes and names for demographic targeting in ad campaigns. |
| `SNAPCHAT_GET_TARGETING_DEVICE_IOS_OS_VERSION` | Get Targeting Device iOS OS Version | Tool to retrieve all available iOS OS version targeting options from Snapchat Marketing API. Use when you need to get the list of iOS versions that can be used for targeting with os_version_min and os_version_max parameters. |
| `SNAPCHAT_GET_TARGETING_DEVICE_MARKETING_NAMES` | Get Targeting Device Marketing Names | Tool to retrieve available device marketing names for targeting from Snapchat Marketing API. Use when you need to get the list of device makes and models that can be used for ad targeting. |
| `SNAPCHAT_GET_TARGETING_GEO_POSTAL_CODE` | Get Targeting Geo Postal Codes | Tool to retrieve postal code targeting options by country code from Snapchat Marketing API. Use when you need to get the list of postal codes available for ad targeting in a specific country. |
| `SNAPCHAT_GET_TARGETING_GEO_REGION` | Get Targeting Geo Region | Tool to retrieve region targeting options for a specific country from Snapchat Marketing API. Use when you need to get the list of regions (states, provinces, etc.) that can be used for ad targeting within a particular country. |
| `SNAPCHAT_GET_TARGETING_GEO_US_POSTAL_CODE` | Get Targeting Geo US Postal Codes | Tool to retrieve all US postal code targeting options from Snapchat Marketing API. Use when you need to get the list of US ZIP codes available for ad targeting with geographic hierarchy data. |
| `SNAPCHAT_GET_TARGETING_GEO_US_REGION` | Get Targeting Geo US Region | Tool to retrieve all available US region targeting options from Snapchat Marketing API. Use when you need to fetch the list of US states/regions available for geographic ad targeting. |
| `SNAPCHAT_GET_TARGETING_INTERESTS_DLXC` | Get Targeting Interests DLXC | Tool to retrieve Oracle Datalogix DLXC interest targeting options from Snapchat Marketing API. Use when you need to fetch available DLXC interest categories for ad targeting. Note: This endpoint is deprecated as of September 27, 2024. |
| `SNAPCHAT_GET_TARGETING_INTERESTS_DLXP` | Get Targeting Interests DLXP | Tool to retrieve Oracle Datalogix DLXP interest targeting options from Snapchat Marketing API. Use when you need to fetch business dealer and service targeting options for ad campaigns. Note: This endpoint is deprecated. |
| `SNAPCHAT_GET_TARGETING_INTERESTS_DLXS` | Get Targeting Interests DLXS | Tool to retrieve all available Oracle Datalogix (DLXS) interest targeting options from Snapchat Marketing API. Use when you need to get the list of DLXS interests that can be used for ad targeting. |
| `SNAPCHAT_GET_TARGETING_INTERESTS_NLN` | Get Targeting Interests NLN | Tool to retrieve all available Nielsen interest targeting options from Snapchat Marketing API. Use when you need to get Nielsen-based interest categories for audience targeting in ad campaigns. |
| `SNAPCHAT_GET_TARGETING_INTERESTS_PLC` | Get Targeting Interests PLC | Tool to retrieve all available PLC (Placed Visitation Segments) targeting options from Snapchat Marketing API. Use when you need to get location-based interest segments for audience targeting in ad campaigns. |
| `SNAPCHAT_GET_TARGETING_LOCATION_CATEGORIES_LOI` | Get Location Category LOI Options | Tool to retrieve all location category (LOI - Locations of Interest) targeting options from Snapchat Marketing API. Use when you need to fetch the list of venue types and business categories available for location-based ad targeting. |
| `SNAPCHAT_GET_TARGETING_METROS` | Get Targeting Metros | Tool to retrieve metro/DMA targeting options by country code from Snapchat Marketing API. Use when you need to get the list of metro areas available for ad targeting in a specific country. |
| `SNAPCHAT_GET_TARGETING_OS_TYPES` | Get Targeting OS Types | Tool to retrieve available OS type targeting options from Snapchat Marketing API. Use when you need to get the list of operating system types (e.g., iOS, Android) that can be used for ad targeting. |
| `SNAPCHAT_GET_TARGETING_OS_VERSIONS` | Get Targeting OS Versions | Tool to retrieve available OS versions for targeting from Snapchat Marketing API. Use when you need to get the list of iOS or Android versions that can be used for targeting with os_version_min and os_version_max parameters. |
| `SNAPCHAT_GET_TARGETING_V1_INTERESTS_SC_LS` | Get Targeting V1 Interests SCLS | Tool to retrieve all Snap Lifestyle Categories V1 targeting options from Snapchat Marketing API. Use when you need to fetch interest-based targeting categories for ad campaigns. |
| `SNAPCHAT_GET_TARGETING_V1_INTERESTS_SHP` | Get Targeting V1 Interests Shp | Tool to retrieve first-party shopper segment targeting options from Snapchat Marketing API. Use when you need to get shopper segments for ad targeting based on consumer purchase behavior. |
| `SNAPCHAT_GET_TARGETING_V1_INTERESTS_VAC` | Get Targeting VAC Interests | Tool to retrieve First-Party Visitation Segments (VAC interests) for targeting from Snapchat Marketing API. Use when you need to fetch venue categories based on locations users have visited (e.g., restaurants, retail stores). |
| `SNAPCHAT_GET_TARGETING_V1_OPTIONS` | Get Targeting V1 Options | Tool to retrieve all available targeting v1 options from Snapchat Marketing API. Use when you need to get the list of targeting dimensions available for ad targeting in a specific country. |
| `SNAPCHAT_LIST_ACCOUNT_ROLES` | List Account Roles | Tool to retrieve all roles for a Snapchat Ad Account. Use when you need to view all member access permissions assigned within an account. |
| `SNAPCHAT_LIST_AD_ACCOUNTS` | List Ad Accounts | Tool to retrieve all ad accounts associated with an organization from Snapchat Marketing API. Use when you need to list or fetch all ad accounts for a specific organization. |
| `SNAPCHAT_LIST_ADS_BY_ACCOUNT` | List Ads by Account | Tool to retrieve all ads for a specific ad account from Snapchat Marketing API. Use when you need to list all ads associated with an ad account. |
| `SNAPCHAT_LIST_ADS_BY_AD_SQUAD` | List Ads by Ad Squad | Tool to retrieve all ads for a specific ad squad from Snapchat Marketing API. Use when you need to list all ads associated with an ad squad. |
| `SNAPCHAT_LIST_ADS_BY_CAMPAIGN` | List Ads by Campaign | Tool to retrieve all ads for a specific campaign from Snapchat Marketing API. Use when you need to list or fetch all ads associated with a particular campaign. |
| `SNAPCHAT_LIST_AD_SQUADS` | List Ad Squads by Campaign | Tool to retrieve all ad squads for a specific campaign. Use when you need to list or fetch ad squads belonging to a particular Snapchat campaign. |
| `SNAPCHAT_LIST_BILLING_CENTERS` | List Billing Centers | Tool to retrieve all billing centers for a Snapchat Ads organization. Use when you need to fetch a complete list of billing centers associated with an organization. |
| `SNAPCHAT_LIST_CAMPAIGNS` | List Campaigns | Tool to retrieve all campaigns for a specific ad account from Snapchat Marketing API. Use when you need to list all campaigns within an ad account. |
| `SNAPCHAT_LIST_CATALOG_ROLES` | List Catalog Roles | Tool to retrieve all roles for a Snapchat catalog. Use when you need to view all member access permissions assigned within a catalog. |
| `SNAPCHAT_LIST_CREATIVES` | List Creatives | Tool to retrieve all creatives for a specific ad account from Snapchat Marketing API. Use when you need to list all creative assets within an ad account. |
| `SNAPCHAT_LIST_FUNDING_SOURCES` | List Funding Sources | Tool to retrieve all funding sources for a specific organization from Snapchat Marketing API. Use when you need to list all payment methods (credit cards, PayPal, lines of credit, coupons) available for an organization. |
| `SNAPCHAT_LIST_INVOICES` | List Invoices | Tool to retrieve all invoices for an ad account from Snapchat Marketing API. Use when you need to fetch billing information for all invoices associated with a specific ad account. |
| `SNAPCHAT_LIST_MEDIA` | List Media | Tool to retrieve all media files for a specific Snapchat ad account. Use when you need to list all media assets (images, videos, lenses, or playable ads) available in an ad account. |
| `SNAPCHAT_LIST_MEMBER_ROLES` | List Member Roles | Tool to retrieve all roles assigned to a member in Snapchat Marketing API. Use when you need to see all permissions a member has across organizations, ad accounts, and catalogs. |
| `SNAPCHAT_LIST_MEMBERS` | List Organization Members | Tool to retrieve all members of a Snapchat organization. Use when you need to view all users who have access to an organization, including their status (INVITED or MEMBER). |
| `SNAPCHAT_LIST_ORGANIZATIONS` | List Organizations | Tool to retrieve all organizations that the authenticated user has access to from Snapchat Marketing API. Use when you need to list all organizations for the current user. |
| `SNAPCHAT_LIST_ORG_PIXELS` | List Organization Pixels | Tool to retrieve all Snap Pixels for a specific organization from Snapchat Marketing API. Use when you need to list tracking pixels across all ad accounts within an organization. |
| `SNAPCHAT_LIST_ORG_ROLES` | List Organization Roles | Tool to retrieve all roles for a Snapchat organization. Use when you need to view all member access permissions assigned within an organization. |
| `SNAPCHAT_LIST_PHONE_NUMBERS` | List Phone Numbers | Tool to retrieve all verified phone numbers associated with a Snapchat ad account. Use when you need to list or fetch phone numbers for calling and texting features. |
| `SNAPCHAT_LIST_SEGMENTS` | List Audience Segments | Tool to retrieve all audience segments for an ad account from Snapchat Marketing API. Use when you need to fetch a complete list of segments including customer lists, lookalikes, and engagement audiences. |
| `SNAPCHAT_LIST_SPONSORED_CONTENT` | List Sponsored Content | Tool to retrieve organic sponsored content from Snapchat Ads Library. Use when you need to list all available sponsored content from the library with pagination support. |
| `SNAPCHAT_LIST_TRANSACTIONS` | List Transactions | Tool to retrieve all transactions for an organization from Snapchat Marketing API. Use when you need to fetch transaction history including payments, refunds, and other billing activities. Supports filtering by time range and ad account. |
| `SNAPCHAT_SEARCH_ADS_LIBRARY_SPONSORED_CONTENT` | Search Ads Library Sponsored Content | Tool to search for sponsored content by creator name in Snapchat Ads Library. Use when you need to find ads associated with a specific creator. |
| `SNAPCHAT_SEARCH_CATALOG_PRODUCTS` | Search Catalog Products | Tool to search a catalog for products given a provided filter. Use when you need to find specific products in a catalog based on attributes like brand, availability, price, or other properties. |
| `SNAPCHAT_SEARCH_CATALOGS_HOTELS` | Search Catalogs Hotels | Tool to search for hotels in a Snapchat catalog using filters and pagination. Use when you need to find specific hotels in a catalog by name, price, rating, location, or other attributes. |
| `SNAPCHAT_UPDATE_AD_ACCOUNT` | Update Ad Account | Tool to update an existing ad account within a Snapchat organization. Use when modifying ad account settings such as name, status, billing, or spend caps. Requires the ad account ID and organization ID. All account fields must be provided in the update request. |
| `SNAPCHAT_UPDATE_AD_SQUAD` | Update Ad Squad | Tool to update an existing ad squad within a campaign. Use when modifying ad delivery targeting, budgets, placements, or other settings for an existing Snapchat ad squad. |
| `SNAPCHAT_UPDATE_BILLING_CENTER` | Update Billing Center | Tool to update one or more existing billing centers for a Snapchat Ads organization. Use when you need to modify billing center details such as name, email address, or billing address information. Requires the billing center ID along with organization ID and updated billing information. |
| `SNAPCHAT_UPDATE_CAMPAIGN` | Update Campaign | Tool to update an existing advertising campaign in Snapchat Marketing API. Use when you need to modify campaign properties like name, status, budget, timing, or objectives. |
| `SNAPCHAT_UPDATE_SEGMENT` | Update Audience Segment | Tool to update existing audience segments in Snapchat Ads. Use when you need to modify the name, description, or retention period of audience segments. Only these three fields can be updated; other segment properties are read-only. |
| `SNAPCHAT_UPLOAD_MEDIA_MULTIPART` | Upload Media Multipart | Tool to upload large media files using multipart upload in Snapchat Marketing API. Use when uploading media files larger than 32MB or when you need to upload in chunks for reliability. Start with INIT action to get upload session details. |
| `SNAPCHAT_VALIDATE_CONVERSION_EVENT` | Validate Conversion Event | Tool to validate conversion events before sending them to Snapchat Conversion API. Use when testing pixel implementation or verifying event data format. Checks event structure, required fields, and data types without actually recording the events. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Snapchat Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Snapchat actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List my Snapchat ad accounts and summarize campaign performance for the last 7 days'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List my Snapchat ad accounts and summarize campaign performance for the last 7 days'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Snapchat
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Snapchat tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List my Snapchat ad accounts and summarize campaign performance for the last 7 days')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List my Snapchat ad accounts and summarize campaign performance for the last 7 days'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Snapchat Integration

- Supports both Snapchat MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable Snapchat Ads execution
- Rich coverage for reading, writing, and querying Snapchat business and campaign data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Snapchat access
- Per user and per environment credentials instead of hard-coded OAuth tokens

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know which Snapchat campaign, ad account, or report action ran

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Snapchat Ads data
- Scoped, least privilege access to Snapchat business resources
- Full audit trail of agent actions to support review and compliance

## Use Snapchat with any AI Agent Framework

Choose a framework you want to connect Snapchat with:

- [Claude Cowork](https://composio.dev/toolkits/snapchat/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/snapchat/framework/codex)

## Related Toolkits

- [Metaads](https://composio.dev/toolkits/metaads) - Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.
- [Adrapid](https://composio.dev/toolkits/adrapid) - Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.
- [Adyntel](https://composio.dev/toolkits/adyntel) - Adyntel is an API that retrieves LinkedIn ads for any company using a domain or LinkedIn Page ID. Easily access competitive ad intelligence to power your marketing workflows.
- [Beaconstac](https://composio.dev/toolkits/beaconstac) - Beaconstac is a platform for creating and managing QR codes and proximity beacons. It helps businesses engage customers and track marketing performance with powerful analytics.
- [Campaign cleaner](https://composio.dev/toolkits/campaign_cleaner) - Campaign cleaner is an email campaign optimization tool that boosts compatibility and deliverability across email clients. It helps marketers get better results by cleaning, enhancing, and ensuring high performance for every campaign.
- [Deadline funnel](https://composio.dev/toolkits/deadline_funnel) - Deadline Funnel lets you create personalized deadlines and timers for your marketing campaigns. It helps marketers boost conversions by adding authentic urgency to offers.
- [Google Ads](https://composio.dev/toolkits/googleads) - Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.
- [Instantly](https://composio.dev/toolkits/instantly) - Instantly is a platform for automating cold email outreach, managing leads, and optimizing deliverability. Get better results from email campaigns with minimal manual effort.
- [Keyword](https://composio.dev/toolkits/keyword) - Keyword.com is a digital marketing platform for search rank tracking and SEO analytics. Use it to monitor keyword performance, spot ranking changes, and measure SEO visibility.
- [Linkedin Ads](https://composio.dev/toolkits/linkedin_ads) - Linkedin Ads is LinkedIn's marketing platform for creating, managing, and measuring paid campaigns across LinkedIn. It helps teams reach professional audiences with precise targeting, campaign analytics, and sponsored content tools.
- [Proofly](https://composio.dev/toolkits/proofly) - Proofly is a social proof platform that displays real-time notifications of customer activity on your site. It helps you increase website conversions by building trust and urgency for visitors.
- [Reddit Ads](https://composio.dev/toolkits/reddit_ads) - Reddit Ads is Reddit's advertising platform for running paid campaigns, managing ad accounts, and tracking conversions. It helps advertisers reach high-intent communities with targeted, interest-based campaigns.
- [Segmetrics](https://composio.dev/toolkits/segmetrics) - Segmetrics is a marketing analytics platform that reveals detailed insights into your customer journeys. It helps businesses optimize marketing strategies with accurate, actionable reporting.
- [Semrush](https://composio.dev/toolkits/semrush) - Semrush is a leading SEO tool suite for keyword research, competitor analysis, and campaign tracking. It empowers marketers to improve search rankings and optimize online visibility.
- [Sendloop](https://composio.dev/toolkits/sendloop) - Sendloop is an all-in-one email marketing platform built for SaaS, e-commerce, and small businesses. It makes it easy to send campaigns, manage lists, and track results—all in one place.
- [Sidetracker](https://composio.dev/toolkits/sidetracker) - Sidetracker is a marketing analytics platform that tracks expenses, sales funnels, and customer journeys. It helps optimize marketing spend and visualize campaign performance from start to finish.
- [Stannp](https://composio.dev/toolkits/stannp) - Stannp is an API-driven direct mail platform for sending postcards and letters programmatically. It lets you automate physical mail delivery—no manual printing or mailing required.
- [Tapfiliate](https://composio.dev/toolkits/tapfiliate) - Tapfiliate is an affiliate and referral tracking platform for businesses. It helps companies efficiently manage, track, and grow their affiliate programs.
- [Tpscheck](https://composio.dev/toolkits/tpscheck) - Tpscheck is a real-time service for verifying UK phone numbers against TPS and CTPS registers. It helps prevent unwanted marketing calls and ensures compliance with UK telemarketing laws.
- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

## Frequently Asked Questions

### Do I need my own developer credentials to use Snapchat with Composio?

Yes, Snapchat requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)