Snapchat Ads

Snapchat advertising API for managing the full ad lifecycle on Snapchat. Use to create and manage campaigns, ad squads, ads, creatives, audiences, and pull performance reporting against Snap’s Marketing API. Strongest for reaching Gen Z and AR-format ad surfaces (Lenses, Stories, Spotlight) that other major ad platforms don’t offer. 8 example endpoints available through Lava’s AI Gateway. See the Snapchat Ads API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://adsapi.snapchat.com/v1 is supported. Any Snapchat Marketing API endpoint. Construct URL as https://adsapi.snapchat.com/v1/{path}. Pagination uses the limit query param (50–1000) with response paging.next_link carrying the next-page URL. Errors return JSON with request_status: "ERROR", debug_message, display_message, error_code (e.g., E3003 for not-found). Rate limits: 20 req/sec per app, 10 req/sec per access token. Full reference: https://developers.snap.com/api/marketing-api/Ads-API/introduction The endpoints below are curated examples.

Endpoints

Get the authenticated user (id, organization_id, display_name, email)

GET https://adsapi.snapchat.com/v1/me — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/me', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fme" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List organizations the authenticated user belongs to

GET https://adsapi.snapchat.com/v1/me/organizations — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/me/organizations', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fme%2Forganizations" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List ad accounts under an organization

GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/adaccounts — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/organizations/{organization_id}/adaccounts', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Forganizations%2F%7Borganization_id%7D%2Fadaccounts" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List campaigns under an ad account

GET https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadaccounts%2F%7Bad_account_id%7D%2Fcampaigns" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a campaign in an ad account

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns', {
  body: {
"campaigns": [
  {
    "name": "Summer Launch",
    "ad_account_id": "{ad_account_id}",
    "status": "PAUSED",
    "start_time": "2026-06-01T00:00:00Z",
    "objective": "BRAND_AWARENESS"
  }
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadaccounts%2F%7Bad_account_id%7D%2Fcampaigns" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaigns":[{"name":"Summer Launch","ad_account_id":"{ad_account_id}","status":"PAUSED","start_time":"2026-06-01T00:00:00Z","objective":"BRAND_AWARENESS"}]}'

List ad squads under a campaign

GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/adsquads — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/adsquads', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fcampaigns%2F%7Bcampaign_id%7D%2Fadsquads" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List ads under an ad squad

GET https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/ads — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/ads', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fadsquads%2F%7Bad_squad_id%7D%2Fads" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Get performance stats for a campaign (impressions, swipes, spend)

GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend — Free

SDK
cURL

const data = await lava.gateway('https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/stats?granularity=TOTAL&fields=impressions,swipes,spend', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fadsapi.snapchat.com%2Fv1%2Fcampaigns%2F%7Bcampaign_id%7D%2Fstats%3Fgranularity%3DTOTAL%26fields%3Dimpressions%2Cswipes%2Cspend" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Endpoints

Get the authenticated user (id, organization_id, display_name, email)

List organizations the authenticated user belongs to

List ad accounts under an organization

List campaigns under an ad account

Create a campaign in an ad account

List ad squads under a campaign

List ads under an ad squad

Get performance stats for a campaign (impressions, swipes, spend)

Next Steps

All Providers

Forward Proxy

​Endpoints

​Get the authenticated user (id, organization_id, display_name, email)

​List organizations the authenticated user belongs to

​List ad accounts under an organization

​List campaigns under an ad account

​Create a campaign in an ad account

​List ad squads under a campaign

​List ads under an ad squad

​Get performance stats for a campaign (impressions, swipes, spend)

​Next Steps

All Providers

Forward Proxy

Endpoints

Get the authenticated user (id, organization_id, display_name, email)

List organizations the authenticated user belongs to

List ad accounts under an organization

List campaigns under an ad account

Create a campaign in an ad account

List ad squads under a campaign

List ads under an ad squad

Get performance stats for a campaign (impressions, swipes, spend)

Next Steps