# Focus · Snapchat API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `snapchat-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "display_name": "string",
  "username": "string",
  "description": "string",
  "profile_image_url": "https://example.com",
  "subscriber_count": 1,
  "organization_id": "string",
  "organization_name": "string",
  "category": "string",
  "subcategory": "string",
  "internal_profile_category": "UNKNOWN",
  "profile_type": "STORY_STUDIO_PUBLISHER",
  "profile_tier": "TIER_UNKNOWN",
  "email": "you@example.com",
  "phone_number": "+15551234567",
  "website": "https://example.com",
  "address": {
    "line_1": "string",
    "line_2": "string",
    "line_3": "string",
    "locality": "string",
    "region": "string",
    "district": "string",
    "postal_code": "string",
    "country": "US"
  },
  "country_code_90d": "string",
  "primary_color": "string",
  "share_insights": true,
  "share_expired_stories": true,
  "url": "https://example.com",
  "views_total": 1.5,
  "viewers_total": 1.5,
  "profile_views_total": 1.5,
  "story_views_total": 1.5,
  "saved_story_views_total": 1.5,
  "spotlight_views_total": 1.5
}
```

## 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: `read` · MCP tool: `snapchat-profiles-list` · Zernio: `GET /v1/connect/snapchat/select-profile`, `POST /v1/connect/snapchat/select-profile`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profiles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "display_name": "string",
      "username": "string",
      "description": "string",
      "profile_image_url": "https://example.com",
      "subscriber_count": 1,
      "organization_id": "string",
      "organization_name": "string",
      "category": "string",
      "subcategory": "string",
      "internal_profile_category": "UNKNOWN",
      "profile_type": "STORY_STUDIO_PUBLISHER",
      "profile_tier": "TIER_UNKNOWN",
      "email": "you@example.com",
      "phone_number": "+15551234567",
      "website": "https://example.com",
      "address": {
        "line_1": "string",
        "line_2": "string",
        "line_3": "string",
        "locality": "string",
        "region": "string",
        "district": "string"
      },
      "country_code_90d": "string",
      "primary_color": "string",
      "share_insights": true,
      "share_expired_stories": true,
      "url": "https://example.com",
      "connected": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-organizations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "country": "US",
      "state": "string",
      "ad_account_count": 1,
      "ad_accounts": [
        {
          "id": "string",
          "name": "string",
          "type": "string",
          "status": "string",
          "currency": "USD",
          "timezone": "Europe/Prague"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-stories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "profile_id": "string",
      "type": "PUBLIC_STORY",
      "thumbnail_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "ended_at": "2026-10-13T09:00:00.000Z",
      "active": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-stories-create` · Zernio: `POST /v1/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media` (string; required): One image (JPEG/PNG) or MP4 video (5-60 s), 9:16, ≥540x960
- `ttl` (string; one of ONE_DAY, TWO_DAYS, THREE_DAYS, ONE_WEEK)

```bash
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:

```json
{
  "id": "string",
  "profile_id": "string",
  "type": "PUBLIC_STORY",
  "thumbnail_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "ended_at": "2026-10-13T09:00:00.000Z",
  "active": true
}
```

## 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: `write` · MCP tool: `snapchat-stories-reconcile`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `since` (string (date-time))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-story-snaps-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `story_id` (string)
- `created_at` (string (date-time))
- `ended_at` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/story-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "story_id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "title": "string",
      "caption": "string",
      "link": "https://example.com",
      "ml_tags": [
        "string"
      ],
      "external_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-story-snaps-promote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required): Ad account to claim the media into
- `ad_squad_id` (string | null): Existing ad squad for the new (paused) ad
- `new_campaign` (object | null)
  - `new_campaign.name` (string)
  - `new_campaign.objective` (string)
  - `new_campaign.daily_budget_micro` (integer): Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)
  - `new_campaign.country_codes` (array of string)
- `headline` (string | null; ≤ 34 characters)
- `call_to_action` (string | null)
- `wait_for_ready` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-saved-stories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `visibility` (string; one of ALL, VISIBLE_ON_PROFILE)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "type": "SAVED_STORY",
      "thumbnail_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "external_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-saved-stories-create` · Zernio: `POST /v1/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `title` (string; required; ≤ 45 characters)
- `media` (array of string): New media, uploaded in order after sources
- `sources` (array of object): Existing snaps / spotlights / uploaded media, in playback order
  - `sources[].snap_id` (string)
  - `sources[].spotlight_id` (string)
  - `sources[].media_id` (string): Snap media id (uploaded < 24h ago)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "type": "SAVED_STORY",
  "thumbnail_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "external_id": "string"
}
```

## 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` · MCP tool: `snapchat-saved-stories-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-stories/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-saved-stories-promote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required): Ad account to claim the media into
- `ad_squad_id` (string | null): Existing ad squad for the new (paused) ad
- `new_campaign` (object | null)
  - `new_campaign.name` (string)
  - `new_campaign.objective` (string)
  - `new_campaign.daily_budget_micro` (integer): Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)
  - `new_campaign.country_codes` (array of string)
- `headline` (string | null; ≤ 34 characters)
- `call_to_action` (string | null)
- `wait_for_ready` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-saved-story-snaps-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `saved_story_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/saved-story-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "story_id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "title": "string",
      "caption": "string",
      "link": "https://example.com",
      "ml_tags": [
        "string"
      ],
      "external_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-spotlights-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "status": "SUBMITTED",
      "title": "string",
      "description": "string",
      "hashtags": [
        "string"
      ],
      "duration": 1.5,
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "link": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "sponsor": {
        "profile_id": "string",
        "display_name": "string",
        "sponsor_status": "string"
      },
      "url": "https://example.com",
      "external_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-spotlights-create` · Zernio: `POST /v1/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media` (string; required): MP4 video, 6-60 s, 9:16, ≥540x960
- `description` (string; ≤ 160 characters): Inline #hashtags allowed
- `hashtags` (array of string)
- `locale` (string)

```bash
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:

```json
{
  "id": "string",
  "status": "SUBMITTED",
  "title": "string",
  "description": "string",
  "hashtags": [
    "string"
  ],
  "duration": 1.5,
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "link": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "sponsor": {
    "profile_id": "string",
    "display_name": "string",
    "sponsor_status": "string"
  },
  "url": "https://example.com",
  "external_id": "string"
}
```

## 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` · MCP tool: `snapchat-spotlights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "status": "SUBMITTED",
  "title": "string",
  "description": "string",
  "hashtags": [
    "string"
  ],
  "duration": 1.5,
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "link": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "sponsor": {
    "profile_id": "string",
    "display_name": "string",
    "sponsor_status": "string"
  },
  "url": "https://example.com",
  "external_id": "string"
}
```

## 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` · MCP tool: `snapchat-spotlights-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/spotlights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-spotlights-check-status`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-spotlights-promote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required): Ad account to claim the media into
- `ad_squad_id` (string | null): Existing ad squad for the new (paused) ad
- `new_campaign` (object | null)
  - `new_campaign.name` (string)
  - `new_campaign.objective` (string)
  - `new_campaign.daily_budget_micro` (integer): Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)
  - `new_campaign.country_codes` (array of string)
- `headline` (string | null; ≤ 34 characters)
- `call_to_action` (string | null)
- `wait_for_ready` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-lenses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/lenses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "status": "string",
      "icon_url": "https://example.com",
      "snapcode": {},
      "preview_media": {},
      "rejection_errors": [
        {}
      ],
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "updated_by": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-lenses-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/lenses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "status": "string",
  "icon_url": "https://example.com",
  "snapcode": {},
  "preview_media": {},
  "rejection_errors": [
    {}
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "updated_by": "string"
}
```

## 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` · MCP tool: `snapchat-shared-snaps-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `aggregate` (boolean)
- `from` (string (date-time))
- `to` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/shared-snaps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "story_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "sponsor_status": "PENDING",
      "display_name": "string",
      "username": "string",
      "story_type": "string",
      "multi_snaps_bundle_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-shared-snaps-promote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required): Ad account to claim the media into
- `ad_squad_id` (string | null): Existing ad squad for the new (paused) ad
- `new_campaign` (object | null)
  - `new_campaign.name` (string)
  - `new_campaign.objective` (string)
  - `new_campaign.daily_budget_micro` (integer): Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)
  - `new_campaign.country_codes` (array of string)
- `headline` (string | null; ≤ 34 characters)
- `call_to_action` (string | null)
- `wait_for_ready` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-media-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media` (string; required)

```bash
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:

```json
{
  "media_id": "string",
  "type": "IMAGE",
  "name": "string",
  "parts": 1,
  "size": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `read` · MCP tool: `snapchat-profile-insights-list` · Zernio: `GET /v1/analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (≤ 90 days back)
- `until` (string (date)): YYYY-MM-DD, inclusive
- `fields` (array of string): Snap field names (default: all PROFILE fields)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/profile-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "views": 1.5,
      "reach": 1.5,
      "profile_views": 1.5,
      "followers": 1.5,
      "follower_change": 1.5,
      "shares": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "clicks": 1.5,
      "engagements": 1.5,
      "watch_time_seconds": 1.5,
      "avg_view_duration_seconds": 1.5,
      "native": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-audience-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (≤ 90 days back)
- `until` (string (date)): YYYY-MM-DD, inclusive
- `dimension` (string; one of AGE, GENDER, COUNTRY, REGION, OS, SUBSCRIPTION, AGE_GENDER, COUNTRY_GENDER, COUNTRY_AGE, COUNTRY_SUBSCRIPTION)
- `metric` (string; one of VIEWERS, VIEWS, SUBSCRIBERS)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "dimension": "AGE",
      "key": "string",
      "age": "string",
      "gender": "string",
      "value": 1.5,
      "percentage": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `snapchat-content-insights-list` · Zernio: `GET /v1/analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (≤ 90 days back)
- `until` (string (date)): YYYY-MM-DD, inclusive
- `asset_type` (string; one of stories, saved_stories, spotlights, lenses)
- `sort` (string)
- `limit` (integer; 10–1000)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/content-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "asset_id": "string",
      "asset_type": "STORY",
      "VIEWS": 1.5,
      "VIEWERS": 1.5,
      "SHARES": 1.5,
      "INTERACTIONS": 1.5,
      "SWIPE_UPS": 1.5,
      "VIEW_TIME_MILLIS": 1.5,
      "AVG_VIEW_TIME_MILLIS": 1.5,
      "FAVORITES": 1.5,
      "SCREENSHOTS": 1.5,
      "REPLIES": 1.5,
      "COMPLETES": 1.5,
      "LENS_PLAYS": 1.5,
      "SCANS": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `snapchat-asset-insights-list` · Zernio: `GET /v1/analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (≤ 90 days back)
- `until` (string (date)): YYYY-MM-DD, inclusive
- `id` (string): Socialit external id (spotlight:…, saved_story:…, story:…, snap:…, lens:…)
- `kind` (string; one of story, snap, saved_story, spotlight, lens): Kind for bare ids
- `granularity` (string; one of DAY, TOTAL, LIFETIME)
- `breakdown` (string; one of AGE_GENDER, COUNTRY, INTEREST_CATEGORY_ID, OS, PLACEMENT, PLATFORM, PRODUCT, PRODUCT_CATEGORY, REGION, SDK_VERSION, SPONSOR_TYPE)
- `field` (string): Field for breakdowns

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/asset-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "views": 1.5,
      "reach": 1.5,
      "profile_views": 1.5,
      "followers": 1.5,
      "follower_change": 1.5,
      "shares": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "clicks": 1.5,
      "engagements": 1.5,
      "watch_time_seconds": 1.5,
      "avg_view_duration_seconds": 1.5,
      "native": {},
      "key": "string",
      "value": 1.5,
      "percentage": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-creator-search-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `query` (string)
- `limit` (integer; 1–100)
- `category` (string; one of CATEGORY_PERSON, CATEGORY_BUSINESS)
- `tier` (string; one of TIER_PUBLIC, TIER_PUBLIC_OFFICIAL)
- `include_standard` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "display_name": "string",
      "username": "string",
      "description": "string",
      "profile_image_url": "https://example.com",
      "subscriber_count": 1,
      "organization_id": "string",
      "organization_name": "string",
      "category": "string",
      "subcategory": "string",
      "internal_profile_category": "UNKNOWN",
      "profile_type": "STORY_STUDIO_PUBLISHER",
      "profile_tier": "TIER_UNKNOWN",
      "email": "you@example.com",
      "phone_number": "+15551234567",
      "website": "https://example.com",
      "address": {
        "line_1": "string",
        "line_2": "string",
        "line_3": "string",
        "locality": "string",
        "region": "string",
        "district": "string"
      },
      "country_code_90d": "string",
      "primary_color": "string",
      "share_insights": true,
      "share_expired_stories": true,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-creator-discovery-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `query` (string)
- `countries` (array of string)
- `categories` (array of string)
- `audience_countries` (array of string)
- `audience_gender` (string; one of GENDER_MALE, GENDER_FEMALE)
- `min_followers` (integer)
- `max_followers` (integer)
- `min_spotlight_views` (integer)
- `max_spotlight_views` (integer)
- `share_insights` (boolean)
- `share_expired_stories` (boolean)
- `snap_stars_only` (boolean)
- `has_paid_partnership_experience` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-discovery" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "display_name": "string",
      "username": "string",
      "description": "string",
      "profile_image_url": "https://example.com",
      "subscriber_count": 1,
      "organization_id": "string",
      "organization_name": "string",
      "category": "string",
      "subcategory": "string",
      "internal_profile_category": "UNKNOWN",
      "profile_type": "STORY_STUDIO_PUBLISHER",
      "profile_tier": "TIER_UNKNOWN",
      "email": "you@example.com",
      "phone_number": "+15551234567",
      "website": "https://example.com",
      "address": {
        "line_1": "string",
        "line_2": "string",
        "line_3": "string",
        "locality": "string",
        "region": "string",
        "district": "string"
      },
      "country_code_90d": "string",
      "primary_color": "string",
      "share_insights": true,
      "share_expired_stories": true,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-creator-profiles-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/creator-profiles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "display_name": "string",
  "username": "string",
  "description": "string",
  "profile_image_url": "https://example.com",
  "subscriber_count": 1,
  "organization_id": "string",
  "organization_name": "string",
  "category": "string",
  "subcategory": "string",
  "internal_profile_category": "UNKNOWN",
  "profile_type": "STORY_STUDIO_PUBLISHER",
  "profile_tier": "TIER_UNKNOWN",
  "email": "you@example.com",
  "phone_number": "+15551234567",
  "website": "https://example.com",
  "address": {
    "line_1": "string",
    "line_2": "string",
    "line_3": "string",
    "locality": "string",
    "region": "string",
    "district": "string",
    "postal_code": "string",
    "country": "US"
  },
  "country_code_90d": "string",
  "primary_color": "string",
  "share_insights": true,
  "share_expired_stories": true,
  "url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-creator-profiles-saved-stories`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-creator-profiles-spotlights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-creator-profiles-lenses`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-creator-profiles-by-snap`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `snap_id` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-partnerships-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `include_pending` (boolean)
- `include_expired` (boolean)
- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "creator_profile_id": "string",
      "invitee_user_id": "string",
      "creator_display_name": "string",
      "creator_username": "string",
      "creator_thumbnail_url": "https://example.com",
      "creator_tier": "string",
      "role_status": "PENDING",
      "role_type": "string",
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z",
      "share_insights": true,
      "share_expired_stories": true,
      "share_content_for_ads": true,
      "shared_public_profile_level": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-partnerships-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `username` (string; required): Creator Snapchat username
- `user_id` (string): Creator user id (pre-approved creator)
- `display_name` (string)
- `approval_time_in_days` (integer; one of 7, 30, 90): Omit for no expiry

```bash
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:

```json
{
  "id": "string",
  "creator_profile_id": "string",
  "invitee_user_id": "string",
  "creator_display_name": "string",
  "creator_username": "string",
  "creator_thumbnail_url": "https://example.com",
  "creator_tier": "string",
  "role_status": "PENDING",
  "role_type": "string",
  "start_time": "2026-10-13T09:00:00.000Z",
  "end_time": "2026-10-13T09:00:00.000Z",
  "share_insights": true,
  "share_expired_stories": true,
  "share_content_for_ads": true,
  "shared_public_profile_level": "string"
}
```

## 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` · MCP tool: `snapchat-partnerships-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partnerships/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-partnerships-permissions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `creator_profile_id` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-partner-roles-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/partner-roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "invitee_username": "string",
      "invitee_display_name": "string",
      "invitee_user_id": "string",
      "invitee_profile_id": "string",
      "profile_logo_url": "https://example.com",
      "role_type": "string",
      "role_status": "PENDING",
      "profile_tier": "string",
      "partnership_level": "string",
      "approval_time_in_days": 1,
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-collaboration-messages-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `creator_profile_id` (string)
- `conversation_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/collaboration-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "type": "TEXT",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-collaboration-messages-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `creator_profile_id` (string)
- `conversation_id` (string)
- `text` (string; required; ≥ 1 characters)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "type": "TEXT",
  "direction": "in",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "from_id": "string"
}
```

## 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: `write` · MCP tool: `snapchat-collaboration-messages-unread-count`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-roster-change-logs-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `feed_type` (string; one of INCREMENTAL, FULL_SNAPSHOT)
- `start_at` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/roster-change-logs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "url": "https://example.com",
      "filename": "string",
      "exported_at": "2026-10-13T09:00:00.000Z",
      "shard_index": 1,
      "shard_count": 1,
      "size_bytes": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-ad-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/ad-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "status": "string",
      "currency": "USD",
      "timezone": "Europe/Prague",
      "organization_id": "string",
      "organization_name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-campaigns-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `ad_account_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/campaigns" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "status": "ACTIVE",
      "ad_account_id": "string",
      "objective": "string",
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z",
      "daily_budget_micro": 1,
      "lifetime_spend_cap_micro": 1,
      "delivery_status": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-ad-squads-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): next_cursor from the previous page
- `ad_account_id` (string)
- `campaign_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/ad-squads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "status": "ACTIVE",
      "campaign_id": "string",
      "type": "string",
      "optimization_goal": "string",
      "bid_strategy": "string",
      "daily_budget_micro": 1,
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z",
      "delivery_status": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `snapchat-promotions-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/promotions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "media_id": "string",
  "status": "claimed",
  "creative": {
    "id": "string",
    "name": "string",
    "review_status": "string"
  },
  "campaign": {
    "id": "string",
    "name": "string",
    "status": "string"
  },
  "ad_squad": {
    "id": "string",
    "name": "string",
    "status": "string"
  },
  "ad": {
    "id": "string",
    "name": "string",
    "status": "string",
    "review_status": "string"
  }
}
```

## 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: `write` · MCP tool: `snapchat-promotions-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `external_id` (string): snap:…, spotlight:… or saved_story:…
- `snap_id` (string)
- `ad_code` (string): Creator-generated ad code
- `ad_account_id` (string; required)
- `ad_squad_id` (string)
- `new_campaign` (object)
  - `new_campaign.name` (string)
  - `new_campaign.objective` (string)
  - `new_campaign.daily_budget_micro` (integer)
  - `new_campaign.country_codes` (array of string)
- `headline` (string; ≤ 34 characters)
- `call_to_action` (string)
- `wait_for_ready` (boolean)

```bash
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:

```json
{
  "media_id": "string",
  "status": "claimed",
  "creative": {
    "id": "string",
    "name": "string",
    "review_status": "string"
  },
  "campaign": {
    "id": "string",
    "name": "string",
    "status": "string"
  },
  "ad_squad": {
    "id": "string",
    "name": "string",
    "status": "string"
  },
  "ad": {
    "id": "string",
    "name": "string",
    "status": "string",
    "review_status": "string"
  }
}
```

## 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: `write` · MCP tool: `snapchat-promotions-complete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required)
- `ad_squad_id` (string)
- `headline` (string)
- `call_to_action` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-promotions-extract-snap-id`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `url` (string (uri))
- `short_url_code` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-promotions-claim-ad-code`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required)
- `ad_code` (string; required)
- `profile_id` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `snapchat-promotions-combine-snaps`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ad_account_id` (string; required)
- `snap_ids` (array of string; required; ≥ 1 items)
- `tagged_profile_id` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `snapchat-sharing-policies-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `ad_account_id` (string)
- `types` (array of string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/sharing-policies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "source_type": "string",
      "source_id": "string",
      "target_type": "adaccounts",
      "target_id": "string",
      "parent_policy_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `snapchat-sharing-policies-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `resource_type` (string)
- `resource_id` (string): Defaults to this profile
- `target_type` (string; required; one of adaccounts, organizations)
- `target_id` (string; required)
- `parent_policy_id` (string): Required when sharing to an external ad account

```bash
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:

```json
{
  "id": "string",
  "source_type": "string",
  "source_id": "string",
  "target_type": "adaccounts",
  "target_id": "string",
  "parent_policy_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `snapchat-sharing-policies-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/snapchat/sharing-policies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-snapchat/
