Focus · Snapchat
Typed Focus mode operations for Snapchat accounts, generated from the Snapchat focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_snapchat- Profile1
- Profiles1
- Organizations1
- Stories3
- Story snaps2
- Saved stories4
- Saved story snaps1
- Spotlights6
- Lenses2
- Shared snaps2
- Media1
- Profile insights1
- Audience1
- Content insights1
- Asset insights1
- Creator search1
- Creator discovery1
- Creator profiles5
- Partnerships4
- Partner roles1
- Collaboration messages3
- Roster change logs1
- Ad accounts1
- Campaigns1
- Ad squads1
- Promotions6
- Sharing policies3
Profile
Snapchat: Get Profile
/accounts/{accountId}/snapchat/profileGET /v1/public_profiles/{profile_id} + lifetime profile stats. Public Profile details and headline numbers. Snap profile APIs are read only: edit name, bio and avatar in the Snapchat app. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call snapchat-profile-get (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlydisplay_namestringusernamestringdescriptionstring | nullprofile_image_urlstring (uri) | nullsubscriber_countinteger | nullorganization_idstring | nullorganization_namestring | nullcategorystring | nullsubcategorystring | nullinternal_profile_categorystring | nullUNKNOWNBUSINESSPERSONPUBLISHER
profile_typestring | nullSTORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT
profile_tierstring | nullTIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL
emailstring | nullphone_numberstring | nullwebsitestring (uri) | nulladdressobject | nullShow 8 child attributes
line_1string | nullline_2string | nullline_3string | nulllocalitystring | nullregionstring | nulldistrictstring | nullpostal_codestring | nullcountrystring | nullcountry_code_90dstring | nullprimary_colorstring | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullurlstring (uri) | nullviews_totalnumber | nullread-onlyviewers_totalnumber | nullread-onlyprofile_views_totalnumber | nullread-onlystory_views_totalnumber | nullread-onlysaved_story_views_totalnumber | nullread-onlyspotlight_views_totalnumber | nullread-onlyResponses
Profiles
Snapchat: List Managed profiles
/accounts/{accountId}/snapchat/profilesGET my_profile + GET /v1/organizations/{id}/public_profiles. Every Public Profile this login can manage (my_profile + organization profiles). Connect another one to switch. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Profiles Generic route: /v1/accounts/{accountId}/focus/profiles.
Try it with MCPAsk your agent to call snapchat-profiles-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringread-onlydisplay_namestringusernamestringdescriptionstring | nullprofile_image_urlstring (uri) | nullsubscriber_countinteger | nullorganization_idstring | nullorganization_namestring | nullcategorystring | nullsubcategorystring | nullinternal_profile_categorystring | nullUNKNOWNBUSINESSPERSONPUBLISHER
profile_typestring | nullSTORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT
profile_tierstring | nullTIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL
emailstring | nullphone_numberstring | nullwebsitestring (uri) | nulladdressobject | nullShow 8 child attributes
line_1string | nullline_2string | nullline_3string | nulllocalitystring | nullregionstring | nulldistrictstring | nullpostal_codestring | nullcountrystring | nullcountry_code_90dstring | nullprimary_colorstring | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullurlstring (uri) | nullconnectedbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Organizations
Snapchat: List Organizations
/accounts/{accountId}/snapchat/organizationsGET adsapi /v1/me/organizations?with_ad_accounts=true. Snap Business Manager organizations and their ad accounts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/organizations Generic route: /v1/accounts/{accountId}/focus/organizations.
Try it with MCPAsk your agent to call snapchat-organizations-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlynamestringtypestring | nullcountrystring | nullstatestring | nullad_account_countintegerread-onlyad_accountsarray of objectShow 6 item attributes
idstringnamestringtypestring | nullstatusstring | nullcurrencystring | nulltimezonestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Stories
Snapchat: List Stories
/accounts/{accountId}/snapchat/storiesGET /v1/public_profiles/{profile_id}/stories. Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call snapchat-stories-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlyprofile_idstring | nulltypestringdefault: "PUBLIC_STORY"thumbnail_urlstring (uri) | nullcreated_atstring (date-time)ended_atstring (date-time) | nullactivebooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Stories item
/accounts/{accountId}/snapchat/storiesEncrypt + upload media, then POST /v1/public_profiles/{profile_id}/stories. Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call snapchat-stories-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredOne image (JPEG/PNG) or MP4 video (5-60 s), 9:16, ≥540x960
ttlstringdefault: "ONE_DAY"ONE_DAYTWO_DAYSTHREE_DAYSONE_WEEK
Returns object
idstringread-onlyprofile_idstring | nulltypestringdefault: "PUBLIC_STORY"thumbnail_urlstring (uri) | nullcreated_atstring (date-time)ended_atstring (date-time) | nullactivebooleanread-onlyResponses
Snapchat: Find posted snap (Stories)
/accounts/{accountId}/snapchat/stories/reconcileLook up the newest snap (Story POST returns no id). Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call snapchat-stories-reconcile (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sincestring (date-time)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Story snaps
Snapchat: List Story snaps
/accounts/{accountId}/snapchat/story-snapsGET /v1/public_profiles/{profile_id}/stories/{story_id}/snaps. Snaps inside a Story. Time bounds are filled from the story to avoid timeouts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/story-snaps.
Try it with MCPAsk your agent to call snapchat-story-snaps-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
story_idstringcreated_atstring (date-time)ended_atstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlystory_idstring | nullmedia_typestring | nullIMAGEVIDEO
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullcreated_atstring (date-time)titlestring | nullcaptionstring | nulllinkstring (uri) | nullml_tagsarray of string | nullImage tags (extra allowlist)
external_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Promote (Story snaps)
/accounts/{accountId}/snapchat/story-snaps/{itemId}/promoteClaim into an ad account and create a paused creative / ad (Ads API). Snaps inside a Story. Time bounds are filled from the story to avoid timeouts. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/story-snaps.
Try it with MCPAsk your agent to call snapchat-story-snaps-promote (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredAd account to claim the media into
ad_squad_idstring | nullExisting ad squad for the new (paused) ad
new_campaignobject | nullShow 4 child attributes
namestringobjectivestringdefault: "AWARENESS_AND_ENGAGEMENT"daily_budget_microintegerAd squad daily budget in micro-currency (e.g. 20000000 = 20.00)
country_codesarray of stringdefault: ["us"]headlinestring | null≤ 34 characters
call_to_actionstring | nullwait_for_readybooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Saved stories
Snapchat: List Saved Stories
/accounts/{accountId}/snapchat/saved-storiesGET /v1/public_profiles/{profile_id}/saved_stories. Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/saved-stories.
Try it with MCPAsk your agent to call snapchat-saved-stories-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
visibilitystringdefault: "ALL"ALLVISIBLE_ON_PROFILE
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlytitlestring≤ 45 characters
typestringdefault: "SAVED_STORY"thumbnail_urlstring (uri) | nullcreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlyexternal_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Saved Stories item
/accounts/{accountId}/snapchat/saved-storiesPOST /v1/public_profiles/{profile_id}/saved_stories (one per request, ≤ 5 min total). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/saved-stories.
Try it with MCPAsk your agent to call snapchat-saved-stories-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequired≤ 45 characters
mediaarray of stringNew media, uploaded in order after sources
sourcesarray of objectExisting snaps / spotlights / uploaded media, in playback order
Show 3 item attributes
snap_idstringspotlight_idstringmedia_idstringSnap media id (uploaded < 24h ago)
Returns object
idstringread-onlytitlestring≤ 45 characters
typestringdefault: "SAVED_STORY"thumbnail_urlstring (uri) | nullcreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlyexternal_idstringread-onlyResponses
Snapchat: Delete a Saved Stories item
/accounts/{accountId}/snapchat/saved-stories/{itemId}DELETE /v1/public_profiles/{profile_id}/saved_stories/{id} (permanent). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/saved-stories.
Try it with MCPAsk your agent to call snapchat-saved-stories-delete (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Snapchat: Promote (Saved Stories)
/accounts/{accountId}/snapchat/saved-stories/{itemId}/promoteClaim into an ad account and create a paused creative / ad (Ads API). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/saved-stories.
Try it with MCPAsk your agent to call snapchat-saved-stories-promote (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredAd account to claim the media into
ad_squad_idstring | nullExisting ad squad for the new (paused) ad
new_campaignobject | nullShow 4 child attributes
namestringobjectivestringdefault: "AWARENESS_AND_ENGAGEMENT"daily_budget_microintegerAd squad daily budget in micro-currency (e.g. 20000000 = 20.00)
country_codesarray of stringdefault: ["us"]headlinestring | null≤ 34 characters
call_to_actionstring | nullwait_for_readybooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Saved story snaps
Snapchat: List Saved Story snaps
/accounts/{accountId}/snapchat/saved-story-snapsGET /v1/public_profiles/{profile_id}/saved_stories/{id}/snaps. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/saved-story-snaps.
Try it with MCPAsk your agent to call snapchat-saved-story-snaps-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
saved_story_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlystory_idstring | nullmedia_typestring | nullIMAGEVIDEO
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullcreated_atstring (date-time)titlestring | nullcaptionstring | nulllinkstring (uri) | nullml_tagsarray of string | nullImage tags (extra allowlist)
external_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Spotlights
Snapchat: List Spotlight
/accounts/{accountId}/snapchat/spotlightsGET /v1/public_profiles/{profile_id}/spotlights. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlystatusstringread-onlySUBMITTEDLIVEREJECTED
titlestring | nulldescriptionstring | null≤ 160 characters
hashtagsarray of stringdurationnumber | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nulllinkstring (uri) | nullcreated_atstring (date-time)read-onlysponsorobject | nullShow 3 child attributes
profile_idstringdisplay_namestringsponsor_statusstringurlstring (uri) | nullexternal_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Spotlight item
/accounts/{accountId}/snapchat/spotlightsEncrypt + upload video, then POST /v1/public_profiles/{profile_id}/spotlights. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredMP4 video, 6-60 s, 9:16, ≥540x960
descriptionstringInline #hashtags allowed
≤ 160 characters
hashtagsarray of stringlocalestringdefault: "en_US"Returns object
idstringread-onlystatusstringread-onlySUBMITTEDLIVEREJECTED
titlestring | nulldescriptionstring | null≤ 160 characters
hashtagsarray of stringdurationnumber | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nulllinkstring (uri) | nullcreated_atstring (date-time)read-onlysponsorobject | nullShow 3 child attributes
profile_idstringdisplay_namestringsponsor_statusstringurlstring (uri) | nullexternal_idstringread-onlyResponses
Snapchat: Get a Spotlight item
/accounts/{accountId}/snapchat/spotlights/{itemId}GET /v1/public_profiles/{profile_id}/spotlights/{id}. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-get (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlystatusstringread-onlySUBMITTEDLIVEREJECTED
titlestring | nulldescriptionstring | null≤ 160 characters
hashtagsarray of stringdurationnumber | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nulllinkstring (uri) | nullcreated_atstring (date-time)read-onlysponsorobject | nullShow 3 child attributes
profile_idstringdisplay_namestringsponsor_statusstringurlstring (uri) | nullexternal_idstringread-onlyResponses
Snapchat: Delete a Spotlight item
/accounts/{accountId}/snapchat/spotlights/{itemId}DELETE /v1/public_profiles/{profile_id}/spotlights/{id}. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-delete (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Snapchat: Check moderation status (Spotlight)
/accounts/{accountId}/snapchat/spotlights/{itemId}/check-statusPoll SUBMITTED → LIVE / REJECTED. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-check-status (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Promote (Spotlight)
/accounts/{accountId}/snapchat/spotlights/{itemId}/promoteClaim into an ad account and create a paused creative / ad (Ads API). Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/spotlights.
Try it with MCPAsk your agent to call snapchat-spotlights-promote (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredAd account to claim the media into
ad_squad_idstring | nullExisting ad squad for the new (paused) ad
new_campaignobject | nullShow 4 child attributes
namestringobjectivestringdefault: "AWARENESS_AND_ENGAGEMENT"daily_budget_microintegerAd squad daily budget in micro-currency (e.g. 20000000 = 20.00)
country_codesarray of stringdefault: ["us"]headlinestring | null≤ 34 characters
call_to_actionstring | nullwait_for_readybooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Lenses
Snapchat: List Lenses
/accounts/{accountId}/snapchat/lensesGET /v1/public_profiles/{profile_id}/lenses. Lenses on the profile (read only; Lenses are built in Lens Studio). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/lenses.
Try it with MCPAsk your agent to call snapchat-lenses-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlynamestringstatusstring | nullicon_urlstring (uri) | nullsnapcodeobject | nullpreview_mediaobject | nullrejection_errorsarray of object | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullupdated_bystring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Get a Lenses item
/accounts/{accountId}/snapchat/lenses/{itemId}GET /v1/public_profiles/{profile_id}/lenses/{id}. Lenses on the profile (read only; Lenses are built in Lens Studio). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/lenses.
Try it with MCPAsk your agent to call snapchat-lenses-get (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlynamestringstatusstring | nullicon_urlstring (uri) | nullsnapcodeobject | nullpreview_mediaobject | nullrejection_errorsarray of object | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullupdated_bystring | nullResponses
Shared snaps
Snapchat: List Collaboration snaps
/accounts/{accountId}/snapchat/shared-snapsGET /v1/public_profiles/{profile_id}/shared_snaps. Paid-partnership snaps from creators that tag this brand profile. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/shared-snaps.
Try it with MCPAsk your agent to call snapchat-shared-snaps-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
aggregatebooleandefault: truefromstring (date-time)tostring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlystory_idstring | nullcreated_atstring (date-time)media_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullsponsor_statusstring | nullPENDINGREJECTEDNOT_SPECIFIEDAUTO_APPROVED
display_namestring | nullusernamestring | nullstory_typestring | nullmulti_snaps_bundle_idstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Promote (Collaboration snaps)
/accounts/{accountId}/snapchat/shared-snaps/{itemId}/promoteClaim into an ad account and create a paused creative / ad (Ads API). Paid-partnership snaps from creators that tag this brand profile. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/shared-snaps.
Try it with MCPAsk your agent to call snapchat-shared-snaps-promote (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredAd account to claim the media into
ad_squad_idstring | nullExisting ad squad for the new (paused) ad
new_campaignobject | nullShow 4 child attributes
namestringobjectivestringdefault: "AWARENESS_AND_ENGAGEMENT"daily_budget_microintegerAd squad daily budget in micro-currency (e.g. 20000000 = 20.00)
country_codesarray of stringdefault: ["us"]headlinestring | null≤ 34 characters
call_to_actionstring | nullwait_for_readybooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Media
Snapchat: Create a Media uploads item
/accounts/{accountId}/snapchat/mediaPOST /v1/public_profiles/{profile_id}/media → ADD parts → FINALIZE. Encrypted (AES-256-CBC) upload to Snap, e.g. to compose a Saved Story. Snap media expires 24h after upload, so upload right before posting. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call snapchat-media-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredReturns object
media_idstringread-onlytypestringIMAGEVIDEO
namestringpartsintegerread-onlysizeintegerread-onlycreated_atstring (date-time)read-onlyexpires_atstring (date-time)read-onlyResponses
Profile insights
Snapchat: List Profile insights
/accounts/{accountId}/snapchat/profile-insightsGET /v1/public_profiles/{profile_id}/stats?granularity=DAY (+ TOTAL for period totals). Daily views, unique viewers, profile views, subscribers, shares and watch time (last 90 days max). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: /v1/accounts/{accountId}/focus/profile-insights.
Try it with MCPAsk your agent to call snapchat-profile-insights-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (≤ 90 days back)
untilstring (date)YYYY-MM-DD, inclusive
fieldsarray of stringSnap field names (default: all PROFILE fields)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
datestring (date)viewsnumber | nullreachnumber | nullUnique viewers
profile_viewsnumber | nullfollowersnumber | nullSubscribers
follower_changenumber | nullSubscribes − unsubscribes
sharesnumber | nulllikesnumber | nullFavorites
commentsnumber | nullReplies
clicksnumber | nullSwipe ups
engagementsnumber | nullInteractions
watch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullnativeobject | nullRaw Snap fields (SCREENSHOTS, COMPLETES, …)
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Audience
Snapchat: List Audience
/accounts/{accountId}/snapchat/audienceGET /v1/public_profiles/{profile_id}/stats?breakdownDimensions=…. Viewer or subscriber demographics: age × gender, country, region, OS, subscription. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: /v1/accounts/{accountId}/focus/audience.
Try it with MCPAsk your agent to call snapchat-audience-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (≤ 90 days back)
untilstring (date)YYYY-MM-DD, inclusive
dimensionstringdefault: "AGE_GENDER"AGEGENDERCOUNTRYREGIONOSSUBSCRIPTIONAGE_GENDERCOUNTRY_GENDERCOUNTRY_AGECOUNTRY_SUBSCRIPTION
metricstringdefault: "VIEWERS"VIEWERSVIEWSSUBSCRIBERS
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
dimensionstringAGEGENDERCOUNTRYREGIONOSSUBSCRIPTIONAGE_GENDERCOUNTRY_GENDERCOUNTRY_AGECOUNTRY_SUBSCRIPTION
keystringagestring | nullgenderstring | nullvaluenumberpercentagenumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Content insights
Snapchat: List Content performance
/accounts/{accountId}/snapchat/content-insightsGET /v1/public_profiles/{profile_id}/stats?assetType=STORY|SAVED_STORY|SPOTLIGHT|LENS. Per-asset performance for Stories, Saved Stories, Spotlights or Lenses, sorted by a metric. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: /v1/accounts/{accountId}/focus/content-insights.
Try it with MCPAsk your agent to call snapchat-content-insights-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (≤ 90 days back)
untilstring (date)YYYY-MM-DD, inclusive
asset_typestringdefault: "spotlights"storiessaved_storiesspotlightslenses
sortstringdefault: "VIEWS"limitintegerdefault: 10010–1000
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
asset_idstringasset_typestringSTORYSAVED_STORYSPOTLIGHTLENS
VIEWSnumber | nullVIEWERSnumber | nullSHARESnumber | nullINTERACTIONSnumber | nullSWIPE_UPSnumber | nullVIEW_TIME_MILLISnumber | nullAVG_VIEW_TIME_MILLISnumber | nullFAVORITESnumber | nullSCREENSHOTSnumber | nullREPLIESnumber | nullCOMPLETESnumber | nullLENS_PLAYSnumber | nullSCANSnumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Asset insights
Snapchat: List Post insights
/accounts/{accountId}/snapchat/asset-insightsGET …/{stories|saved_stories|spotlights}/{id}/stats or /v1/snaps/{id}/stats. Timeseries or breakdown for one Story, Story snap, Saved Story, Spotlight or Lens. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: /v1/accounts/{accountId}/focus/asset-insights.
Try it with MCPAsk your agent to call snapchat-asset-insights-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (≤ 90 days back)
untilstring (date)YYYY-MM-DD, inclusive
idstringSocialit external id (spotlight:…, saved_story:…, story:…, snap:…, lens:…)
kindstringKind for bare ids
storysnapsaved_storyspotlightlens
granularitystringdefault: "DAY"DAYTOTALLIFETIME
breakdownstringAGE_GENDERCOUNTRYINTEREST_CATEGORY_IDOSPLACEMENTPLATFORMPRODUCTPRODUCT_CATEGORYREGIONSDK_VERSIONSPONSOR_TYPE
fieldstringdefault: "VIEWS"Field for breakdowns
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
datestring (date)viewsnumber | nullreachnumber | nullUnique viewers
profile_viewsnumber | nullfollowersnumber | nullSubscribers
follower_changenumber | nullSubscribes − unsubscribes
sharesnumber | nulllikesnumber | nullFavorites
commentsnumber | nullReplies
clicksnumber | nullSwipe ups
engagementsnumber | nullInteractions
watch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullnativeobject | nullRaw Snap fields (SCREENSHOTS, COMPLETES, …)
keystring | nullvaluenumber | nullpercentagenumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Creator search
Snapchat: List Search profiles
/accounts/{accountId}/snapchat/creator-searchGET /public/v1/public_profiles/search. Find Public Profiles by username or display name. If nothing comes back, retry with include_standard. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-search.
Try it with MCPAsk your agent to call snapchat-creator-search-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
querystringlimitintegerdefault: 501–100
categorystringCATEGORY_PERSONCATEGORY_BUSINESS
tierstringTIER_PUBLICTIER_PUBLIC_OFFICIAL
include_standardbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringread-onlydisplay_namestringusernamestringdescriptionstring | nullprofile_image_urlstring (uri) | nullsubscriber_countinteger | nullorganization_idstring | nullorganization_namestring | nullcategorystring | nullsubcategorystring | nullinternal_profile_categorystring | nullUNKNOWNBUSINESSPERSONPUBLISHER
profile_typestring | nullSTORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT
profile_tierstring | nullTIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL
emailstring | nullphone_numberstring | nullwebsitestring (uri) | nulladdressobject | nullShow 8 child attributes
line_1string | nullline_2string | nullline_3string | nulllocalitystring | nullregionstring | nulldistrictstring | nullpostal_codestring | nullcountrystring | nullcountry_code_90dstring | nullprimary_colorstring | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Creator discovery
Snapchat: List Discover creators
/accounts/{accountId}/snapchat/creator-discoveryGET /public/v1/public_profiles/discover. Filter Snap creators by country, category, followers, audience and partnership readiness (≤ 5,000 results per query). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-discovery.
Try it with MCPAsk your agent to call snapchat-creator-discovery-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
querystringcountriesarray of stringcategoriesarray of stringaudience_countriesarray of stringaudience_genderstringGENDER_MALEGENDER_FEMALE
min_followersintegermax_followersintegermin_spotlight_viewsintegermax_spotlight_viewsintegershare_insightsbooleanshare_expired_storiesbooleansnap_stars_onlybooleanhas_paid_partnership_experiencebooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringread-onlydisplay_namestringusernamestringdescriptionstring | nullprofile_image_urlstring (uri) | nullsubscriber_countinteger | nullorganization_idstring | nullorganization_namestring | nullcategorystring | nullsubcategorystring | nullinternal_profile_categorystring | nullUNKNOWNBUSINESSPERSONPUBLISHER
profile_typestring | nullSTORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT
profile_tierstring | nullTIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL
emailstring | nullphone_numberstring | nullwebsitestring (uri) | nulladdressobject | nullShow 8 child attributes
line_1string | nullline_2string | nullline_3string | nulllocalitystring | nullregionstring | nulldistrictstring | nullpostal_codestring | nullcountrystring | nullcountry_code_90dstring | nullprimary_colorstring | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Creator profiles
Snapchat: Get a Creator profile item
/accounts/{accountId}/snapchat/creator-profiles/{itemId}GET /public/v1/public_profiles/{profile_id}. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-profiles.
Try it with MCPAsk your agent to call snapchat-creator-profiles-get (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlydisplay_namestringusernamestringdescriptionstring | nullprofile_image_urlstring (uri) | nullsubscriber_countinteger | nullorganization_idstring | nullorganization_namestring | nullcategorystring | nullsubcategorystring | nullinternal_profile_categorystring | nullUNKNOWNBUSINESSPERSONPUBLISHER
profile_typestring | nullSTORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT
profile_tierstring | nullTIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL
emailstring | nullphone_numberstring | nullwebsitestring (uri) | nulladdressobject | nullShow 8 child attributes
line_1string | nullline_2string | nullline_3string | nulllocalitystring | nullregionstring | nulldistrictstring | nullpostal_codestring | nullcountrystring | nullcountry_code_90dstring | nullprimary_colorstring | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullurlstring (uri) | nullResponses
Snapchat: Saved Stories (Creator profile)
/accounts/{accountId}/snapchat/creator-profiles/{itemId}/saved-storiesSaved Stories. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-profiles.
Try it with MCPAsk your agent to call snapchat-creator-profiles-saved-stories (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Spotlights (Creator profile)
/accounts/{accountId}/snapchat/creator-profiles/{itemId}/spotlightsSpotlights. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-profiles.
Try it with MCPAsk your agent to call snapchat-creator-profiles-spotlights (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Lenses (Creator profile)
/accounts/{accountId}/snapchat/creator-profiles/{itemId}/lensesLenses. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-profiles.
Try it with MCPAsk your agent to call snapchat-creator-profiles-lenses (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Find profile by Snap id (Creator profile)
/accounts/{accountId}/snapchat/creator-profiles/by-snapFind profile by Snap id. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/creator-profiles.
Try it with MCPAsk your agent to call snapchat-creator-profiles-by-snap (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
snap_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Partnerships
Snapchat: List Creator partnerships
/accounts/{accountId}/snapchat/partnershipsGET /v1/public_profiles/{brand_profile_id}/creator_partnerships. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: /v1/accounts/{accountId}/focus/partnerships.
Try it with MCPAsk your agent to call snapchat-partnerships-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
include_pendingbooleandefault: trueinclude_expiredbooleandefault: falselimitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringread-onlyinvitee_user_id (used to cancel)
creator_profile_idstring | nullinvitee_user_idstring | nullcreator_display_namestring | nullcreator_usernamestring | nullcreator_thumbnail_urlstring (uri) | nullcreator_tierstring | nullrole_statusstring | nullPENDINGAPPROVEDEXPIREDREJECTED
role_typestring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullshare_content_for_adsboolean | nullshared_public_profile_levelstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Creator partnerships item
/accounts/{accountId}/snapchat/partnershipsPOST /v1/public_profiles/{brand_profile_id}/roles (invite creator). Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: /v1/accounts/{accountId}/focus/partnerships.
Try it with MCPAsk your agent to call snapchat-partnerships-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequiredCreator Snapchat username
user_idstringCreator user id (pre-approved creator)
display_namestringapproval_time_in_daysintegerOmit for no expiry
73090
Returns object
idstringread-onlyinvitee_user_id (used to cancel)
creator_profile_idstring | nullinvitee_user_idstring | nullcreator_display_namestring | nullcreator_usernamestring | nullcreator_thumbnail_urlstring (uri) | nullcreator_tierstring | nullrole_statusstring | nullPENDINGAPPROVEDEXPIREDREJECTED
role_typestring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullshare_insightsboolean | nullshare_expired_storiesboolean | nullshare_content_for_adsboolean | nullshared_public_profile_levelstring | nullResponses
Snapchat: Delete a Creator partnerships item
/accounts/{accountId}/snapchat/partnerships/{itemId}DELETE /v1/public_profiles/{brand_profile_id}/roles/{invitee_user_id}. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: /v1/accounts/{accountId}/focus/partnerships.
Try it with MCPAsk your agent to call snapchat-partnerships-delete (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Snapchat: Permissions (Creator partnerships)
/accounts/{accountId}/snapchat/partnerships/{itemId}/permissionsGET /v1/public_profiles/{brand_profile_id}/brand_partnership_permissions. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: /v1/accounts/{accountId}/focus/partnerships.
Try it with MCPAsk your agent to call snapchat-partnerships-permissions (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
creator_profile_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Partner roles
Snapchat: List Partner invitations
/accounts/{accountId}/snapchat/partner-rolesGET /v1/public_profiles/{brand_profile_id}/roles?role_type=business_account_story_contributor. Invitation roles and their status (PENDING → APPROVED / REJECTED / EXPIRED). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: /v1/accounts/{accountId}/focus/partner-roles.
Try it with MCPAsk your agent to call snapchat-partner-roles-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlyinvitee_usernamestringinvitee_display_namestring | nullinvitee_user_idstring | nullinvitee_profile_idstring | nullprofile_logo_urlstring (uri) | nullrole_typestringrole_statusstring | nullPENDINGAPPROVEDEXPIREDREJECTED
profile_tierstring | nullpartnership_levelstring | nullapproval_time_in_daysinteger | nullstart_timestring (date-time) | nullend_timestring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Collaboration messages
Snapchat: List Creator messages
/accounts/{accountId}/snapchat/collaboration-messagesGET /v1/public_profiles/{profile_id}/group_conversation(_messages). Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: /v1/accounts/{accountId}/focus/collaboration-messages.
Try it with MCPAsk your agent to call snapchat-collaboration-messages-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
creator_profile_idstringconversation_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlytextstringtypestringTEXT
directionstringinout
sent_atstring (date-time) | nullfrom_idstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Creator messages item
/accounts/{accountId}/snapchat/collaboration-messagesPOST /v1/public_profiles/{profile_id}/group_conversation_messages. Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: /v1/accounts/{accountId}/focus/collaboration-messages.
Try it with MCPAsk your agent to call snapchat-collaboration-messages-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
creator_profile_idstringconversation_idstringtextstringrequired≥ 1 characters
Returns object
idstringread-onlytextstringtypestringTEXT
directionstringinout
sent_atstring (date-time) | nullfrom_idstring | nullResponses
Snapchat: Unread count (Creator messages)
/accounts/{accountId}/snapchat/collaboration-messages/unread-countUnread count. Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: /v1/accounts/{accountId}/focus/collaboration-messages.
Try it with MCPAsk your agent to call snapchat-collaboration-messages-unread-count (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Roster change logs
Snapchat: List Creator roster exports
/accounts/{accountId}/snapchat/roster-change-logsGET /public/v1/public_profiles/change_logs. Signed CSV exports of creator roster changes (URLs expire after 1 h). FULL_SNAPSHOT needs Creator Discovery approval. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: /v1/accounts/{accountId}/focus/roster-change-logs.
Try it with MCPAsk your agent to call snapchat-roster-change-logs-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
feed_typestringdefault: "INCREMENTAL"INCREMENTALFULL_SNAPSHOT
start_atstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlyurlstring (uri)filenamestringexported_atstring (date-time)shard_indexinteger | nullshard_countinteger | nullsize_bytesinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Ad accounts
Snapchat: List Ad accounts
/accounts/{accountId}/snapchat/ad-accountsGET adsapi /v1/me/organizations?with_ad_accounts=true. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/organizations Generic route: /v1/accounts/{accountId}/focus/ad-accounts.
Try it with MCPAsk your agent to call snapchat-ad-accounts-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlynamestringtypestring | nullstatusstring | nullcurrencystring | nulltimezonestring | nullorganization_idstringorganization_namestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Campaigns
Snapchat: List Campaigns
/accounts/{accountId}/snapchat/campaignsGET adsapi /v1/adaccounts/{ad_account_id}/campaigns. Campaigns of an ad account (read only here; manage them in the Snapchat Ads area). Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/campaigns Generic route: /v1/accounts/{accountId}/focus/campaigns.
Try it with MCPAsk your agent to call snapchat-campaigns-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
ad_account_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlynamestringstatusstringACTIVEPAUSED
ad_account_idstringobjectivestring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nulldaily_budget_microinteger | nulllifetime_spend_cap_microinteger | nulldelivery_statusarray of string | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Ad squads
Snapchat: List Ad squads
/accounts/{accountId}/snapchat/ad-squadsGET adsapi /v1/campaigns/{campaign_id}/adsquads or /v1/adaccounts/{id}/adsquads. Ad squads to attach a promoted post to. Cursor pagination: pass next_cursor back as cursor. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/ad-squads Generic route: /v1/accounts/{accountId}/focus/ad-squads.
Try it with MCPAsk your agent to call snapchat-ad-squads-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 201–100
cursorstringnext_cursor from the previous page
ad_account_idstringcampaign_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlynamestringstatusstringACTIVEPAUSED
campaign_idstringtypestring | nulloptimization_goalstring | nullbid_strategystring | nulldaily_budget_microinteger | nullstart_timestring (date-time) | nullend_timestring (date-time) | nulldelivery_statusarray of string | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Promotions
Snapchat: Get a Promote a post item
/accounts/{accountId}/snapchat/promotions/{itemId}GET adsapi /v1/media/{media_id} (claimed media status). Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-get (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
media_idstringread-onlyClaimed ad media id
statusstringclaimedpending_mediacreative_createdad_created
creativeobject | nullShow 3 child attributes
idstringnamestringreview_statusstring | nullcampaignobject | nullShow 3 child attributes
idstringnamestringstatusstringad_squadobject | nullShow 3 child attributes
idstringnamestringstatusstringadobject | nullShow 4 child attributes
idstringnamestringstatusstringreview_statusstring | nullResponses
Snapchat: Create a Promote a post item
/accounts/{accountId}/snapchat/promotionsclaim_media_by_snap_reference | combine_snaps | claim_media_by_ad_code → creatives → ads. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
external_idstringsnap:…, spotlight:… or saved_story:…
snap_idstringad_codestringCreator-generated ad code
ad_account_idstringrequiredad_squad_idstringnew_campaignobjectShow 4 child attributes
namestringobjectivestringdefault: "AWARENESS_AND_ENGAGEMENT"daily_budget_microintegercountry_codesarray of stringheadlinestring≤ 34 characters
call_to_actionstringwait_for_readybooleandefault: trueReturns object
media_idstringread-onlyClaimed ad media id
statusstringclaimedpending_mediacreative_createdad_created
creativeobject | nullShow 3 child attributes
idstringnamestringreview_statusstring | nullcampaignobject | nullShow 3 child attributes
idstringnamestringstatusstringad_squadobject | nullShow 3 child attributes
idstringnamestringstatusstringadobject | nullShow 4 child attributes
idstringnamestringstatusstringreview_statusstring | nullResponses
Snapchat: Create creative / ad (Promote a post)
/accounts/{accountId}/snapchat/promotions/{itemId}/completeFinish a promotion once the claimed media is READY. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-complete (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredad_squad_idstringheadlinestringcall_to_actionstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Snap id from link (Promote a post)
/accounts/{accountId}/snapchat/promotions/extract-snap-idSnap id from link. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-extract-snap-id (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
urlstring (uri)short_url_codestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Claim by ad code (Promote a post)
/accounts/{accountId}/snapchat/promotions/claim-ad-codeClaim by ad code. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-claim-ad-code (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredad_codestringrequiredprofile_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Snapchat: Combine snaps (Promote a post)
/accounts/{accountId}/snapchat/promotions/combine-snapsCombine snaps. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: /v1/accounts/{accountId}/focus/promotions.
Try it with MCPAsk your agent to call snapchat-promotions-combine-snaps (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequiredsnap_idsarray of stringrequired≥ 1 items
tagged_profile_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Sharing policies
Snapchat: List Profile sharing
/accounts/{accountId}/snapchat/sharing-policiesGET /v1/adaccounts/{ad_account_id}/sharing_policies. Share this Public Profile with another ad account or organization (agency / cross-org setups). Cursor pagination: pass next_cursor back as cursor. Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/sharing-policies.
Try it with MCPAsk your agent to call snapchat-sharing-policies-list (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
ad_account_idstringtypesarray of stringdefault: ["public_profiles"]Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlysource_typestringsource_idstringtarget_typestringadaccountsorganizations
target_idstringparent_policy_idstring | nullcreated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Snapchat: Create a Profile sharing item
/accounts/{accountId}/snapchat/sharing-policiesPOST /v1/{resource_type}/{resource_id}/sharing_policies. Share this Public Profile with another ad account or organization (agency / cross-org setups). Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/sharing-policies.
Try it with MCPAsk your agent to call snapchat-sharing-policies-create (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
resource_typestringdefault: "public_profiles"resource_idstringDefaults to this profile
target_typestringrequiredadaccountsorganizations
target_idstringrequiredparent_policy_idstringRequired when sharing to an external ad account
Returns object
idstringread-onlysource_typestringsource_idstringtarget_typestringadaccountsorganizations
target_idstringparent_policy_idstring | nullcreated_atstring (date-time) | nullResponses
Snapchat: Delete a Profile sharing item
/accounts/{accountId}/snapchat/sharing-policies/{itemId}DELETE /v1/sharing_policies/{id}. Share this Public Profile with another ad account or organization (agency / cross-org setups). Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: /v1/accounts/{accountId}/focus/sharing-policies.
Try it with MCPAsk your agent to call snapchat-sharing-policies-delete (toolset focus_snapchat)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultany