For Agents
Manage Snapchat ad accounts, campaigns, ad squads, creatives, audiences, pixels, custom conversions, and product catalogs through OAuth 2.0.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Snapchat Marketing API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Snapchat Marketing API.
List and manage organisations, ad accounts, members, and roles for Snapchat advertising
Create and update campaigns, ad squads, ads, and creatives across an ad account
Build and update custom audience segments and saved targeting profiles
GET STARTED
Use for: I want to launch a new Snapchat campaign for an ad account, List all ad squads under campaign 12345, Create a new ad creative from uploaded media, Update a custom audience segment with a new email list
Not supported: Does not handle Snapchat consumer messaging, Stories, or Snap Map data — use for advertising, audience, measurement, and product catalog operations only.
Jentic publishes the only available OpenAPI specification for the Snapchat Marketing API, keeping it validated and agent-ready. The API exposes 114 endpoints for managing ad accounts, organisations, campaigns, ad squads, ads, creatives, media, custom and saved audience segments, targeting, measurement, pixels, custom conversions, catalogs, product feeds, and product sets on Snapchat. Use it to launch and report on Snapchat ad campaigns, manage members and roles across organisations, and operate product catalogs for dynamic ads. Authentication is OAuth 2.0.
Configure Snapchat Pixels and custom conversions for measurement
Manage product catalogs, product feeds, and product sets for dynamic product ads
Pull measurement data for campaign performance reporting
Patterns agents use Snapchat Marketing API for, with concrete tasks.
★ Snapchat Campaign Launch and Management
Performance marketing teams launch and manage Snapchat campaigns end-to-end via the Campaigns, AdSquads, Ads, and Creatives endpoints. The hierarchy mirrors Snapchat's UI so teams can replicate manual campaign builds in code, including budget caps, scheduling, and creative attachments. This is the foundation for cross-channel ad ops platforms that include Snapchat.
Create a campaign under ad account 999, attach an ad squad with $50/day budget, and launch an ad with creative ID 4421
Custom Audiences and Targeting
Audience teams sync first-party customer lists into Snapchat as custom audience segments using the Segments endpoints, then attach them to ad squads through the Targeting endpoints. Saved targeting profiles can be reused across campaigns to enforce consistent audience definitions.
Update segment 7782 with the latest 50,000 hashed emails from the CRM via the segments endpoints
Conversion Tracking with Pixels and Custom Conversions
Measurement teams configure Snapchat Pixels and custom conversions through the Pixels and CustomConversions endpoints to track on-site events back to ad spend. This is required for ROAS calculations and bid optimisation that uses conversion signals rather than only clicks.
Create a custom conversion for 'add_to_cart' on Pixel 5511 via the custom conversions endpoints and verify events are firing
Dynamic Product Ads via Catalogs
E-commerce advertisers run dynamic product ads on Snapchat by maintaining a Catalog with one or more ProductFeeds and ProductSets. The Catalogs, ProductFeeds, and ProductSets endpoints expose feed scheduling, set rules, and catalog membership so a feed pipeline can be wired up entirely via API.
Create a catalog, attach a product feed pointing at the storefront's CSV URL, and define a product set for the SS26 collection
Agent-Driven Snapchat Ad Ops via Jentic
AI agents can run Snapchat campaign and audience operations through Jentic without orchestrating the full OAuth 2.0 dance themselves. Jentic stores the OAuth credentials in the vault and intent search resolves to the right endpoint among 114, so the agent does not need to read the full marketing-api docs to operate effectively.
Search Jentic for 'list snapchat campaigns', load GET /adaccounts/{ad_account_id}/campaigns, and execute it for ad_account_id 999
114 endpoints — jentic publishes the only available openapi specification for the snapchat marketing api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/me/organizations
List the user's organisations
/organizations/{organization_id}/adaccounts
List ad accounts in an organisation
/adaccounts/{ad_account_id}/campaigns
List campaigns in an ad account
/adaccounts/{ad_account_id}/adsquads
List ad squads in an ad account
/campaigns/{campaign_id}
Get a campaign by ID
/organizations/{organization_id}/fundingsources
List funding sources
/me/organizations
List the user's organisations
/organizations/{organization_id}/adaccounts
List ad accounts in an organisation
/adaccounts/{ad_account_id}/campaigns
List campaigns in an ad account
/adaccounts/{ad_account_id}/adsquads
List ad squads in an ad account
/campaigns/{campaign_id}
Get a campaign by ID
Three things that make agents converge on Jentic-routed access.
Credential isolation
Snapchat OAuth 2.0 client secrets, access tokens, and refresh tokens are stored encrypted in the Jentic vault. Jentic refreshes tokens automatically and never exposes the raw credentials to the agent.
Intent-based discovery
Agents search Jentic by intent (e.g., 'list snapchat campaigns' or 'create snapchat custom audience') and Jentic returns the matching endpoint with its input schema. The agent does not have to traverse the full 114-endpoint surface to find the right operation.
Time to first call
Direct Snapchat Marketing API integration: 3-5 days for OAuth, token refresh, and the campaign-hierarchy edge cases. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Snapchat Marketing API through Jentic.
Why is there no official OpenAPI spec for the Snapchat Marketing API?
Snap publishes documentation at developers.snap.com/api/marketing-api but does not ship an OpenAPI specification. Jentic generates and maintains this spec from the published developer portal so AI agents and developers can call it via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Snapchat Marketing API use?
The API uses OAuth 2.0. You register an app in the Snap Business Manager, run the OAuth authorisation code flow to get an access token and refresh token, and send the access token in the Authorization header. Through Jentic, the OAuth credentials and refresh tokens are held in the vault so the agent never handles them.
Can I create custom audiences with the Snapchat Marketing API?
Yes. The Segments endpoints under /adaccounts/{ad_account_id}/segments let you create and update custom audiences from hashed customer lists, and the Targeting endpoints attach them to ad squads.
How do I list campaigns in an ad account through Jentic?
Search Jentic for 'list snapchat campaigns', load GET /adaccounts/{ad_account_id}/campaigns, and execute it with the ad_account_id. Jentic returns the input schema so the agent supplies only the parameters Snapchat accepts.
What are the rate limits for the Snapchat Marketing API?
Snap enforces per-app and per-account rate limits documented in the Snap developer portal but not in the OpenAPI spec. Expect HTTP 429 responses if you exceed them and retry with exponential backoff. Through Jentic, retries with backoff can be configured in the execution request.
Can I operate product catalogs for dynamic ads with the Snapchat Marketing API?
Yes. Catalogs, ProductFeeds, and ProductSets endpoints together model the dynamic-ad inputs: a catalog holds one or more product feeds and product sets define the slices used in ads.
/organizations/{organization_id}/fundingsources
List funding sources