Snapchat logo

Snapchat

Snapchat Marketing API and Ads Manager integration for creating and managing ad campaigns, analyzing performance metrics, and accessing business accounts.

140 actions Integration catalog
Request access
Connect Snapchat once you're in Boring.
01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Add Users to SegmentSNAPCHAT_ADD_SEGMENT_USERS
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.
Copy Media Between Ad AccountsSNAPCHAT_COPY_MEDIA
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.
Create Account RoleSNAPCHAT_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.
Create Ad AccountSNAPCHAT_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.
Estimate Ad Account Audience SizeSNAPCHAT_CREATE_ADACCOUNTS_AUDIENCE_SIZE_V2
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.
Create ad account creative elementsSNAPCHAT_CREATE_ADACCOUNTS_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.
Create Ad Account Dynamic TemplatesSNAPCHAT_CREATE_ADACCOUNTS_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.
Create Ad Account Event DetailsSNAPCHAT_CREATE_ADACCOUNTS_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.
Create Ad Account Interaction ZonesSNAPCHAT_CREATE_ADACCOUNTS_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.
Create Offer DisclaimersSNAPCHAT_CREATE_ADACCOUNTS_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.
Create ad account reserved forecastingSNAPCHAT_CREATE_ADACCOUNTS_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.
Create Adaccounts Targeting InsightsSNAPCHAT_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.
Create Ad SquadSNAPCHAT_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.
Create Billing CenterSNAPCHAT_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.
Create CampaignSNAPCHAT_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.
Create Catalog RoleSNAPCHAT_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.
Create Catalog FacetsSNAPCHAT_CREATE_CATALOGS_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.
Search Catalog FlightsSNAPCHAT_CREATE_CATALOGS_FLIGHTS_SEARCH
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.
Create Catalogs Product FeedSNAPCHAT_CREATE_CATALOGS_PRODUCT_FEEDS
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.
Create Catalog Product SetSNAPCHAT_CREATE_CATALOGS_PRODUCT_SETS
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.
Create MediaSNAPCHAT_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.
Create Organizations CatalogsSNAPCHAT_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.
Create Organization RoleSNAPCHAT_CREATE_ORG_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.
Create Audience SegmentSNAPCHAT_CREATE_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.
Delete Offer DisclaimerSNAPCHAT_DELETE_ADACCOUNTS_OFFER_DISCLAIMERS
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.
Delete Ad SquadSNAPCHAT_DELETE_ADSQUADS
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.
Delete All Segment UsersSNAPCHAT_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.
Delete CampaignSNAPCHAT_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.
Delete CatalogSNAPCHAT_DELETE_CATALOGS
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.
Delete Event DetailsSNAPCHAT_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.
Delete MemberSNAPCHAT_DELETE_MEMBER
Tool to remove a member from an organization in Snapchat Marketing API. Use when you need to revoke access for a member.
Delete product feedSNAPCHAT_DELETE_PRODUCT_FEEDS
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.
Delete RoleSNAPCHAT_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.
Delete Audience SegmentSNAPCHAT_DELETE_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.
Delete Users from SegmentSNAPCHAT_DELETE_SEGMENT_USERS
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.
Get AdSNAPCHAT_GET_AD
Retrieve the current details of one Snapchat ad by its ID.
Get Ad AccountSNAPCHAT_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.
Get Ad Account Ad SquadsSNAPCHAT_GET_ADACCOUNTS_ADSQUADS
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.
Get Ad Account Ad Squad UI Render DataSNAPCHAT_GET_ADACCOUNTS_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).
Get Ad Account Dynamic TemplatesSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Event DetailsSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Interaction ZonesSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Lead Generation FormsSNAPCHAT_GET_AD_ACCOUNTS_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.
Get Ad Account Leads ReportSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Mobile AppsSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Offer DisclaimersSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account Spend GuidanceSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad Account StatsSNAPCHAT_GET_AD_ACCOUNTS_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.
Get Ad Account Stats ReportSNAPCHAT_GET_ADACCOUNTS_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.
Get Ad SquadSNAPCHAT_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.
Get Ad Squad RestrictionsSNAPCHAT_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.
Get Ad Squad Audience SizeSNAPCHAT_GET_ADSQUADS_AUDIENCE_SIZE_V2
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.
Get Ad Squad Stats ReportSNAPCHAT_GET_ADSQUADS_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.
Get Ad Squad StatsSNAPCHAT_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.
Get Ad Squad TargetingSNAPCHAT_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.
Get Ad StatsSNAPCHAT_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.
Get Authenticated UserSNAPCHAT_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.
Get Billing CenterSNAPCHAT_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.
Get CampaignSNAPCHAT_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.
Get Campaign ChangelogSNAPCHAT_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.
Showing the first 60 of 140 actions.