Skip to content
Docs

Typed Focus mode operations for Snapchat accounts, generated from the Snapchat focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits56 endpointsMCP toolset focus_snapchat

Profile

Snapchat: Get Profile

GET/accounts/{accountId}/snapchat/profile

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-profile-get (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
display_namestring
usernamestring
descriptionstring | null
profile_image_urlstring (uri) | null
subscriber_countinteger | null
organization_idstring | null
organization_namestring | null
categorystring | null
subcategorystring | null
internal_profile_categorystring | null

UNKNOWNBUSINESSPERSONPUBLISHER

profile_typestring | null

STORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT

profile_tierstring | null

TIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL

emailstring | null
phone_numberstring | null
websitestring (uri) | null
addressobject | null
Show 8 child attributes
line_1string | null
line_2string | null
line_3string | null
localitystring | null
regionstring | null
districtstring | null
postal_codestring | null
countrystring | null
country_code_90dstring | null
primary_colorstring | null
share_insightsboolean | null
share_expired_storiesboolean | null
urlstring (uri) | null
views_totalnumber | nullread-only
viewers_totalnumber | nullread-only
profile_views_totalnumber | nullread-only
story_views_totalnumber | nullread-only
saved_story_views_totalnumber | nullread-only
spotlight_views_totalnumber | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Profiles

Snapchat: List Managed profiles

GET/accounts/{accountId}/snapchat/profiles

GET 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.

Access: readZernio: GET /v1/connect/snapchat/select-profilePOST /v1/connect/snapchat/select-profile

Try it with MCPAsk your agent to call snapchat-profiles-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringread-only
display_namestring
usernamestring
descriptionstring | null
profile_image_urlstring (uri) | null
subscriber_countinteger | null
organization_idstring | null
organization_namestring | null
categorystring | null
subcategorystring | null
internal_profile_categorystring | null

UNKNOWNBUSINESSPERSONPUBLISHER

profile_typestring | null

STORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT

profile_tierstring | null

TIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL

emailstring | null
phone_numberstring | null
websitestring (uri) | null
addressobject | null
Show 8 child attributes
line_1string | null
line_2string | null
line_3string | null
localitystring | null
regionstring | null
districtstring | null
postal_codestring | null
countrystring | null
country_code_90dstring | null
primary_colorstring | null
share_insightsboolean | null
share_expired_storiesboolean | null
urlstring (uri) | null
connectedbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/profiles
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profiles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Organizations

Snapchat: List Organizations

GET/accounts/{accountId}/snapchat/organizations

GET 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.

Access: read

Try it with MCPAsk your agent to call snapchat-organizations-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
namestring
typestring | null
countrystring | null
statestring | null
ad_account_countintegerread-only
ad_accountsarray of object
Show 6 item attributes
idstring
namestring
typestring | null
statusstring | null
currencystring | null
timezonestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/organizations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Stories

Snapchat: List Stories

GET/accounts/{accountId}/snapchat/stories

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-stories-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
profile_idstring | null
typestringdefault: "PUBLIC_STORY"
thumbnail_urlstring (uri) | null
created_atstring (date-time)
ended_atstring (date-time) | null
activebooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/stories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Stories item

POST/accounts/{accountId}/snapchat/stories

Encrypt + 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.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call snapchat-stories-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediastringrequired

One image (JPEG/PNG) or MP4 video (5-60 s), 9:16, ≥540x960

ttlstringdefault: "ONE_DAY"

ONE_DAYTWO_DAYSTHREE_DAYSONE_WEEK

Returns object

idstringread-only
profile_idstring | null
typestringdefault: "PUBLIC_STORY"
thumbnail_urlstring (uri) | null
created_atstring (date-time)
ended_atstring (date-time) | null
activebooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/stories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "ttl": "ONE_DAY"
  }'
Response · 201

Snapchat: Find posted snap (Stories)

POST/accounts/{accountId}/snapchat/stories/reconcile

Look 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-stories-reconcile (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/stories/reconcile
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/stories/reconcile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Story snaps

Snapchat: List Story snaps

GET/accounts/{accountId}/snapchat/story-snaps

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-story-snaps-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

story_idstring
created_atstring (date-time)
ended_atstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
story_idstring | null
media_typestring | null

IMAGEVIDEO

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
created_atstring (date-time)
titlestring | null
captionstring | null
linkstring (uri) | null
ml_tagsarray of string | null

Image tags (extra allowlist)

external_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/story-snaps
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/story-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Promote (Story snaps)

POST/accounts/{accountId}/snapchat/story-snaps/{itemId}/promote

Claim 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-story-snaps-promote (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Ad account to claim the media into

ad_squad_idstring | null

Existing ad squad for the new (paused) ad

new_campaignobject | null
Show 4 child attributes
namestring
objectivestringdefault: "AWARENESS_AND_ENGAGEMENT"
daily_budget_microinteger

Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)

country_codesarray of stringdefault: ["us"]
headlinestring | null

≤ 34 characters

call_to_actionstring | null
wait_for_readybooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/story-snaps/{itemId}/promote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/story-snaps/ITEM_ID/promote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_squad_id": "string",
    "new_campaign": {
      "name": "string",
      "objective": "AWARENESS_AND_ENGAGEMENT"
    },
    "headline": "string",
    "call_to_action": "string"
  }'
Response · 200

Saved stories

Snapchat: List Saved Stories

GET/accounts/{accountId}/snapchat/saved-stories

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-saved-stories-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

visibilitystringdefault: "ALL"

ALLVISIBLE_ON_PROFILE

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
titlestring

≤ 45 characters

typestringdefault: "SAVED_STORY"
thumbnail_urlstring (uri) | null
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
external_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/saved-stories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Saved Stories item

POST/accounts/{accountId}/snapchat/saved-stories

POST /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.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call snapchat-saved-stories-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 string

New media, uploaded in order after sources

sourcesarray of object

Existing snaps / spotlights / uploaded media, in playback order

Show 3 item attributes
snap_idstring
spotlight_idstring
media_idstring

Snap media id (uploaded < 24h ago)

Returns object

idstringread-only
titlestring

≤ 45 characters

typestringdefault: "SAVED_STORY"
thumbnail_urlstring (uri) | null
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
external_idstringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/saved-stories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "media": [
      "string"
    ],
    "sources": [
      {
        "snap_id": "string",
        "spotlight_id": "string"
      }
    ]
  }'
Response · 201

Snapchat: Delete a Saved Stories item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call snapchat-saved-stories-delete (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/snapchat/saved-stories/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Promote (Saved Stories)

POST/accounts/{accountId}/snapchat/saved-stories/{itemId}/promote

Claim 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-saved-stories-promote (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Ad account to claim the media into

ad_squad_idstring | null

Existing ad squad for the new (paused) ad

new_campaignobject | null
Show 4 child attributes
namestring
objectivestringdefault: "AWARENESS_AND_ENGAGEMENT"
daily_budget_microinteger

Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)

country_codesarray of stringdefault: ["us"]
headlinestring | null

≤ 34 characters

call_to_actionstring | null
wait_for_readybooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/saved-stories/{itemId}/promote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories/ITEM_ID/promote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_squad_id": "string",
    "new_campaign": {
      "name": "string",
      "objective": "AWARENESS_AND_ENGAGEMENT"
    },
    "headline": "string",
    "call_to_action": "string"
  }'
Response · 200

Saved story snaps

Snapchat: List Saved Story snaps

GET/accounts/{accountId}/snapchat/saved-story-snaps

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-saved-story-snaps-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

saved_story_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
story_idstring | null
media_typestring | null

IMAGEVIDEO

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
created_atstring (date-time)
titlestring | null
captionstring | null
linkstring (uri) | null
ml_tagsarray of string | null

Image tags (extra allowlist)

external_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/saved-story-snaps
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-story-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Spotlights

Snapchat: List Spotlight

GET/accounts/{accountId}/snapchat/spotlights

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-spotlights-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
statusstringread-only

SUBMITTEDLIVEREJECTED

titlestring | null
descriptionstring | null

≤ 160 characters

hashtagsarray of string
durationnumber | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
linkstring (uri) | null
created_atstring (date-time)read-only
sponsorobject | null
Show 3 child attributes
profile_idstring
display_namestring
sponsor_statusstring
urlstring (uri) | null
external_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/spotlights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Spotlight item

POST/accounts/{accountId}/snapchat/spotlights

Encrypt + 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.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call snapchat-spotlights-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediastringrequired

MP4 video, 6-60 s, 9:16, ≥540x960

descriptionstring

Inline #hashtags allowed

≤ 160 characters

hashtagsarray of string
localestringdefault: "en_US"

Returns object

idstringread-only
statusstringread-only

SUBMITTEDLIVEREJECTED

titlestring | null
descriptionstring | null

≤ 160 characters

hashtagsarray of string
durationnumber | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
linkstring (uri) | null
created_atstring (date-time)read-only
sponsorobject | null
Show 3 child attributes
profile_idstring
display_namestring
sponsor_statusstring
urlstring (uri) | null
external_idstringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/spotlights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "description": "string",
    "hashtags": [
      "string"
    ],
    "locale": "en_US"
  }'
Response · 201

Snapchat: Get a Spotlight item

GET/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.

Access: read

Try it with MCPAsk your agent to call snapchat-spotlights-get (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
statusstringread-only

SUBMITTEDLIVEREJECTED

titlestring | null
descriptionstring | null

≤ 160 characters

hashtagsarray of string
durationnumber | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
linkstring (uri) | null
created_atstring (date-time)read-only
sponsorobject | null
Show 3 child attributes
profile_idstring
display_namestring
sponsor_statusstring
urlstring (uri) | null
external_idstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/spotlights/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Delete a Spotlight item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call snapchat-spotlights-delete (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/snapchat/spotlights/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Check moderation status (Spotlight)

POST/accounts/{accountId}/snapchat/spotlights/{itemId}/check-status

Poll 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-spotlights-check-status (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/spotlights/{itemId}/check-status
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID/check-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Snapchat: Promote (Spotlight)

POST/accounts/{accountId}/snapchat/spotlights/{itemId}/promote

Claim 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-spotlights-promote (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Ad account to claim the media into

ad_squad_idstring | null

Existing ad squad for the new (paused) ad

new_campaignobject | null
Show 4 child attributes
namestring
objectivestringdefault: "AWARENESS_AND_ENGAGEMENT"
daily_budget_microinteger

Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)

country_codesarray of stringdefault: ["us"]
headlinestring | null

≤ 34 characters

call_to_actionstring | null
wait_for_readybooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/spotlights/{itemId}/promote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID/promote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_squad_id": "string",
    "new_campaign": {
      "name": "string",
      "objective": "AWARENESS_AND_ENGAGEMENT"
    },
    "headline": "string",
    "call_to_action": "string"
  }'
Response · 200

Lenses

Snapchat: List Lenses

GET/accounts/{accountId}/snapchat/lenses

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-lenses-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
namestring
statusstring | null
icon_urlstring (uri) | null
snapcodeobject | null
preview_mediaobject | null
rejection_errorsarray of object | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
updated_bystring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/lenses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/lenses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Get a Lenses item

GET/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.

Access: read

Try it with MCPAsk your agent to call snapchat-lenses-get (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestring
statusstring | null
icon_urlstring (uri) | null
snapcodeobject | null
preview_mediaobject | null
rejection_errorsarray of object | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
updated_bystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/lenses/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/lenses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Shared snaps

Snapchat: List Collaboration snaps

GET/accounts/{accountId}/snapchat/shared-snaps

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-shared-snaps-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

aggregatebooleandefault: true
fromstring (date-time)
tostring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
story_idstring | null
created_atstring (date-time)
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
sponsor_statusstring | null

PENDINGREJECTEDNOT_SPECIFIEDAUTO_APPROVED

display_namestring | null
usernamestring | null
story_typestring | null
multi_snaps_bundle_idstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/shared-snaps
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/shared-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Promote (Collaboration snaps)

POST/accounts/{accountId}/snapchat/shared-snaps/{itemId}/promote

Claim 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-shared-snaps-promote (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Ad account to claim the media into

ad_squad_idstring | null

Existing ad squad for the new (paused) ad

new_campaignobject | null
Show 4 child attributes
namestring
objectivestringdefault: "AWARENESS_AND_ENGAGEMENT"
daily_budget_microinteger

Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)

country_codesarray of stringdefault: ["us"]
headlinestring | null

≤ 34 characters

call_to_actionstring | null
wait_for_readybooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/shared-snaps/{itemId}/promote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/shared-snaps/ITEM_ID/promote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_squad_id": "string",
    "new_campaign": {
      "name": "string",
      "objective": "AWARENESS_AND_ENGAGEMENT"
    },
    "headline": "string",
    "call_to_action": "string"
  }'
Response · 200

Media

Snapchat: Create a Media uploads item

POST/accounts/{accountId}/snapchat/media

POST /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-media-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediastringrequired

Returns object

media_idstringread-only
typestring

IMAGEVIDEO

namestring
partsintegerread-only
sizeintegerread-only
created_atstring (date-time)read-only
expires_atstring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/media
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string"
  }'
Response · 201

Profile insights

Snapchat: List Profile insights

GET/accounts/{accountId}/snapchat/profile-insights

GET /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.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call snapchat-profile-insights-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (≤ 90 days back)

untilstring (date)

YYYY-MM-DD, inclusive

fieldsarray of string

Snap field names (default: all PROFILE fields)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
datestring (date)
viewsnumber | null
reachnumber | null

Unique viewers

profile_viewsnumber | null
followersnumber | null

Subscribers

follower_changenumber | null

Subscribes − unsubscribes

sharesnumber | null
likesnumber | null

Favorites

commentsnumber | null

Replies

clicksnumber | null

Swipe ups

engagementsnumber | null

Interactions

watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
nativeobject | null

Raw Snap fields (SCREENSHOTS, COMPLETES, …)

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/profile-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profile-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Audience

Snapchat: List Audience

GET/accounts/{accountId}/snapchat/audience

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-audience-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
dimensionstring

AGEGENDERCOUNTRYREGIONOSSUBSCRIPTIONAGE_GENDERCOUNTRY_GENDERCOUNTRY_AGECOUNTRY_SUBSCRIPTION

keystring
agestring | null
genderstring | null
valuenumber
percentagenumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/audience
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Content insights

Snapchat: List Content performance

GET/accounts/{accountId}/snapchat/content-insights

GET /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.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call snapchat-content-insights-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social 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: 100

10–1000

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
asset_idstring
asset_typestring

STORYSAVED_STORYSPOTLIGHTLENS

VIEWSnumber | null
VIEWERSnumber | null
SHARESnumber | null
INTERACTIONSnumber | null
SWIPE_UPSnumber | null
VIEW_TIME_MILLISnumber | null
AVG_VIEW_TIME_MILLISnumber | null
FAVORITESnumber | null
SCREENSHOTSnumber | null
REPLIESnumber | null
COMPLETESnumber | null
LENS_PLAYSnumber | null
SCANSnumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/content-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/content-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Asset insights

Snapchat: List Post insights

GET/accounts/{accountId}/snapchat/asset-insights

GET …/{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.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call snapchat-asset-insights-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (≤ 90 days back)

untilstring (date)

YYYY-MM-DD, inclusive

idstring

Socialit external id (spotlight:…, saved_story:…, story:…, snap:…, lens:…)

kindstring

Kind for bare ids

storysnapsaved_storyspotlightlens

granularitystringdefault: "DAY"

DAYTOTALLIFETIME

breakdownstring

AGE_GENDERCOUNTRYINTEREST_CATEGORY_IDOSPLACEMENTPLATFORMPRODUCTPRODUCT_CATEGORYREGIONSDK_VERSIONSPONSOR_TYPE

fieldstringdefault: "VIEWS"

Field for breakdowns

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
datestring (date)
viewsnumber | null
reachnumber | null

Unique viewers

profile_viewsnumber | null
followersnumber | null

Subscribers

follower_changenumber | null

Subscribes − unsubscribes

sharesnumber | null
likesnumber | null

Favorites

commentsnumber | null

Replies

clicksnumber | null

Swipe ups

engagementsnumber | null

Interactions

watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
nativeobject | null

Raw Snap fields (SCREENSHOTS, COMPLETES, …)

keystring | null
valuenumber | null
percentagenumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/asset-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/asset-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: List Search profiles

GET/accounts/{accountId}/snapchat/creator-search

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-creator-search-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

querystring
limitintegerdefault: 50

1–100

categorystring

CATEGORY_PERSONCATEGORY_BUSINESS

tierstring

TIER_PUBLICTIER_PUBLIC_OFFICIAL

include_standardbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringread-only
display_namestring
usernamestring
descriptionstring | null
profile_image_urlstring (uri) | null
subscriber_countinteger | null
organization_idstring | null
organization_namestring | null
categorystring | null
subcategorystring | null
internal_profile_categorystring | null

UNKNOWNBUSINESSPERSONPUBLISHER

profile_typestring | null

STORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT

profile_tierstring | null

TIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL

emailstring | null
phone_numberstring | null
websitestring (uri) | null
addressobject | null
Show 8 child attributes
line_1string | null
line_2string | null
line_3string | null
localitystring | null
regionstring | null
districtstring | null
postal_codestring | null
countrystring | null
country_code_90dstring | null
primary_colorstring | null
share_insightsboolean | null
share_expired_storiesboolean | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/creator-search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Creator discovery

Snapchat: List Discover creators

GET/accounts/{accountId}/snapchat/creator-discovery

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-creator-discovery-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

querystring
countriesarray of string
categoriesarray of string
audience_countriesarray of string
audience_genderstring

GENDER_MALEGENDER_FEMALE

min_followersinteger
max_followersinteger
min_spotlight_viewsinteger
max_spotlight_viewsinteger
share_insightsboolean
share_expired_storiesboolean
snap_stars_onlyboolean
has_paid_partnership_experienceboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringread-only
display_namestring
usernamestring
descriptionstring | null
profile_image_urlstring (uri) | null
subscriber_countinteger | null
organization_idstring | null
organization_namestring | null
categorystring | null
subcategorystring | null
internal_profile_categorystring | null

UNKNOWNBUSINESSPERSONPUBLISHER

profile_typestring | null

STORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT

profile_tierstring | null

TIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL

emailstring | null
phone_numberstring | null
websitestring (uri) | null
addressobject | null
Show 8 child attributes
line_1string | null
line_2string | null
line_3string | null
localitystring | null
regionstring | null
districtstring | null
postal_codestring | null
countrystring | null
country_code_90dstring | null
primary_colorstring | null
share_insightsboolean | null
share_expired_storiesboolean | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/creator-discovery
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-discovery" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Creator profiles

Snapchat: Get a Creator profile item

GET/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.

Access: read

Try it with MCPAsk your agent to call snapchat-creator-profiles-get (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
display_namestring
usernamestring
descriptionstring | null
profile_image_urlstring (uri) | null
subscriber_countinteger | null
organization_idstring | null
organization_namestring | null
categorystring | null
subcategorystring | null
internal_profile_categorystring | null

UNKNOWNBUSINESSPERSONPUBLISHER

profile_typestring | null

STORY_STUDIO_PUBLISHERPUBLISHER_WITH_HOST_USERPUBLIC_PROFILEPUBLIC_PROFILE_WITH_PUBLISHER_CONTENT

profile_tierstring | null

TIER_UNKNOWNTIER_STANDARDTIER_PUBLICTIER_PUBLIC_OFFICIAL

emailstring | null
phone_numberstring | null
websitestring (uri) | null
addressobject | null
Show 8 child attributes
line_1string | null
line_2string | null
line_3string | null
localitystring | null
regionstring | null
districtstring | null
postal_codestring | null
countrystring | null
country_code_90dstring | null
primary_colorstring | null
share_insightsboolean | null
share_expired_storiesboolean | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/creator-profiles/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Saved Stories (Creator profile)

POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/saved-stories

Saved 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-creator-profiles-saved-stories (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/saved-stories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/ITEM_ID/saved-stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20,
    "cursor": "string"
  }'
Response · 200

Snapchat: Spotlights (Creator profile)

POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/spotlights

Spotlights. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-creator-profiles-spotlights (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/spotlights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/ITEM_ID/spotlights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20,
    "cursor": "string"
  }'
Response · 200

Snapchat: Lenses (Creator profile)

POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/lenses

Lenses. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-creator-profiles-lenses (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/creator-profiles/{itemId}/lenses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/ITEM_ID/lenses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20,
    "cursor": "string"
  }'
Response · 200

Snapchat: Find profile by Snap id (Creator profile)

POST/accounts/{accountId}/snapchat/creator-profiles/by-snap

Find 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-creator-profiles-by-snap (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/creator-profiles/by-snap
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/by-snap" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "snap_id": "string"
  }'
Response · 200

Partnerships

Snapchat: List Creator partnerships

GET/accounts/{accountId}/snapchat/partnerships

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-partnerships-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

include_pendingbooleandefault: true
include_expiredbooleandefault: false
limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only

invitee_user_id (used to cancel)

creator_profile_idstring | null
invitee_user_idstring | null
creator_display_namestring | null
creator_usernamestring | null
creator_thumbnail_urlstring (uri) | null
creator_tierstring | null
role_statusstring | null

PENDINGAPPROVEDEXPIREDREJECTED

role_typestring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
share_insightsboolean | null
share_expired_storiesboolean | null
share_content_for_adsboolean | null
shared_public_profile_levelstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/partnerships
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Creator partnerships item

POST/accounts/{accountId}/snapchat/partnerships

POST /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-partnerships-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

usernamestringrequired

Creator Snapchat username

user_idstring

Creator user id (pre-approved creator)

display_namestring
approval_time_in_daysinteger

Omit for no expiry

73090

Returns object

idstringread-only

invitee_user_id (used to cancel)

creator_profile_idstring | null
invitee_user_idstring | null
creator_display_namestring | null
creator_usernamestring | null
creator_thumbnail_urlstring (uri) | null
creator_tierstring | null
role_statusstring | null

PENDINGAPPROVEDEXPIREDREJECTED

role_typestring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
share_insightsboolean | null
share_expired_storiesboolean | null
share_content_for_adsboolean | null
shared_public_profile_levelstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/partnerships
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "string",
    "user_id": "string",
    "display_name": "string",
    "approval_time_in_days": 7
  }'
Response · 201

Snapchat: Delete a Creator partnerships item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call snapchat-partnerships-delete (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/snapchat/partnerships/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Permissions (Creator partnerships)

POST/accounts/{accountId}/snapchat/partnerships/{itemId}/permissions

GET /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-partnerships-permissions (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/partnerships/{itemId}/permissions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships/ITEM_ID/permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "creator_profile_id": "string"
  }'
Response · 200

Partner roles

Snapchat: List Partner invitations

GET/accounts/{accountId}/snapchat/partner-roles

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-partner-roles-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
invitee_usernamestring
invitee_display_namestring | null
invitee_user_idstring | null
invitee_profile_idstring | null
profile_logo_urlstring (uri) | null
role_typestring
role_statusstring | null

PENDINGAPPROVEDEXPIREDREJECTED

profile_tierstring | null
partnership_levelstring | null
approval_time_in_daysinteger | null
start_timestring (date-time) | null
end_timestring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/partner-roles
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partner-roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Collaboration messages

Snapchat: List Creator messages

GET/accounts/{accountId}/snapchat/collaboration-messages

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-collaboration-messages-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

creator_profile_idstring
conversation_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
textstring
typestring

TEXT

directionstring

inout

sent_atstring (date-time) | null
from_idstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/collaboration-messages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/collaboration-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Creator messages item

POST/accounts/{accountId}/snapchat/collaboration-messages

POST /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-collaboration-messages-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring
conversation_idstring
textstringrequired

≥ 1 characters

Returns object

idstringread-only
textstring
typestring

TEXT

directionstring

inout

sent_atstring (date-time) | null
from_idstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/collaboration-messages
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/collaboration-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "creator_profile_id": "string",
    "conversation_id": "string",
    "text": "string"
  }'
Response · 201

Snapchat: Unread count (Creator messages)

POST/accounts/{accountId}/snapchat/collaboration-messages/unread-count

Unread 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-collaboration-messages-unread-count (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/collaboration-messages/unread-count
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/collaboration-messages/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Roster change logs

Snapchat: List Creator roster exports

GET/accounts/{accountId}/snapchat/roster-change-logs

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-roster-change-logs-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

feed_typestringdefault: "INCREMENTAL"

INCREMENTALFULL_SNAPSHOT

start_atstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
urlstring (uri)
filenamestring
exported_atstring (date-time)
shard_indexinteger | null
shard_countinteger | null
size_bytesinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/roster-change-logs
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/roster-change-logs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Ad accounts

Snapchat: List Ad accounts

GET/accounts/{accountId}/snapchat/ad-accounts

GET 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.

Access: read

Try it with MCPAsk your agent to call snapchat-ad-accounts-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
namestring
typestring | null
statusstring | null
currencystring | null
timezonestring | null
organization_idstring
organization_namestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/ad-accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/ad-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Campaigns

Snapchat: List Campaigns

GET/accounts/{accountId}/snapchat/campaigns

GET 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.

Access: read

Try it with MCPAsk your agent to call snapchat-campaigns-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

ad_account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
namestring
statusstring

ACTIVEPAUSED

ad_account_idstring
objectivestring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
daily_budget_microinteger | null
lifetime_spend_cap_microinteger | null
delivery_statusarray of string | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/campaigns
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/campaigns" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Ad squads

Snapchat: List Ad squads

GET/accounts/{accountId}/snapchat/ad-squads

GET 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.

Access: read

Try it with MCPAsk your agent to call snapchat-ad-squads-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

1–100

cursorstring

next_cursor from the previous page

ad_account_idstring
campaign_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
namestring
statusstring

ACTIVEPAUSED

campaign_idstring
typestring | null
optimization_goalstring | null
bid_strategystring | null
daily_budget_microinteger | null
start_timestring (date-time) | null
end_timestring (date-time) | null
delivery_statusarray of string | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/ad-squads
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/ad-squads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Promotions

Snapchat: Get a Promote a post item

GET/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.

Access: read

Try it with MCPAsk your agent to call snapchat-promotions-get (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

media_idstringread-only

Claimed ad media id

statusstring

claimedpending_mediacreative_createdad_created

creativeobject | null
Show 3 child attributes
idstring
namestring
review_statusstring | null
campaignobject | null
Show 3 child attributes
idstring
namestring
statusstring
ad_squadobject | null
Show 3 child attributes
idstring
namestring
statusstring
adobject | null
Show 4 child attributes
idstring
namestring
statusstring
review_statusstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/promotions/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Promote a post item

POST/accounts/{accountId}/snapchat/promotions

claim_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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-promotions-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring

snap:…, spotlight:… or saved_story:…

snap_idstring
ad_codestring

Creator-generated ad code

ad_account_idstringrequired
ad_squad_idstring
new_campaignobject
Show 4 child attributes
namestring
objectivestringdefault: "AWARENESS_AND_ENGAGEMENT"
daily_budget_microinteger
country_codesarray of string
headlinestring

≤ 34 characters

call_to_actionstring
wait_for_readybooleandefault: true

Returns object

media_idstringread-only

Claimed ad media id

statusstring

claimedpending_mediacreative_createdad_created

creativeobject | null
Show 3 child attributes
idstring
namestring
review_statusstring | null
campaignobject | null
Show 3 child attributes
idstring
namestring
statusstring
ad_squadobject | null
Show 3 child attributes
idstring
namestring
statusstring
adobject | null
Show 4 child attributes
idstring
namestring
statusstring
review_statusstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/promotions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "string",
    "snap_id": "string",
    "ad_code": "string",
    "ad_account_id": "string",
    "ad_squad_id": "string"
  }'
Response · 201

Snapchat: Create creative / ad (Promote a post)

POST/accounts/{accountId}/snapchat/promotions/{itemId}/complete

Finish 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-promotions-complete (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
ad_squad_idstring
headlinestring
call_to_actionstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/promotions/{itemId}/complete
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/ITEM_ID/complete" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_squad_id": "string",
    "headline": "string",
    "call_to_action": "string"
  }'
Response · 200

Snapchat: Snap id from link (Promote a post)

POST/accounts/{accountId}/snapchat/promotions/extract-snap-id

Snap 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-promotions-extract-snap-id (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_codestring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/promotions/extract-snap-id
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/extract-snap-id" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "short_url_code": "string"
  }'
Response · 200

Snapchat: Claim by ad code (Promote a post)

POST/accounts/{accountId}/snapchat/promotions/claim-ad-code

Claim 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-promotions-claim-ad-code (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
ad_codestringrequired
profile_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/promotions/claim-ad-code
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/claim-ad-code" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "ad_code": "string",
    "profile_id": "string"
  }'
Response · 200

Snapchat: Combine snaps (Promote a post)

POST/accounts/{accountId}/snapchat/promotions/combine-snaps

Combine 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-promotions-combine-snaps (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
snap_idsarray of stringrequired

≥ 1 items

tagged_profile_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/promotions/combine-snaps
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/combine-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "string",
    "snap_ids": [
      "string"
    ],
    "tagged_profile_id": "string"
  }'
Response · 200

Sharing policies

Snapchat: List Profile sharing

GET/accounts/{accountId}/snapchat/sharing-policies

GET /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.

Access: read

Try it with MCPAsk your agent to call snapchat-sharing-policies-list (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

ad_account_idstring
typesarray of stringdefault: ["public_profiles"]

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
source_typestring
source_idstring
target_typestring

adaccountsorganizations

target_idstring
parent_policy_idstring | null
created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/snapchat/sharing-policies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/sharing-policies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Snapchat: Create a Profile sharing item

POST/accounts/{accountId}/snapchat/sharing-policies

POST /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call snapchat-sharing-policies-create (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Defaults to this profile

target_typestringrequired

adaccountsorganizations

target_idstringrequired
parent_policy_idstring

Required when sharing to an external ad account

Returns object

idstringread-only
source_typestring
source_idstring
target_typestring

adaccountsorganizations

target_idstring
parent_policy_idstring | null
created_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/snapchat/sharing-policies
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/sharing-policies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "resource_type": "public_profiles",
    "resource_id": "string",
    "target_type": "adaccounts",
    "target_id": "string",
    "parent_policy_id": "string"
  }'
Response · 201

Snapchat: Delete a Profile sharing item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call snapchat-sharing-policies-delete (toolset focus_snapchat)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/snapchat/sharing-policies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/sharing-policies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200