Snapchat APIthrough Siar.

At a glance

Account needed: A Snapchat public profile.

Media rules

What Siar can do on Snapchat

Snapchat does not expose comments through its API, so comment features are not available for Snapchat accounts.

Publish a post

Put Snapchat's payload under data.SNAPCHAT and list SNAPCHAT in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "Snapchat post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "SNAPCHAT"
    ],
    "data": {
      "SNAPCHAT": {
        "type": "STORY",
        "uploadIds": [
          "UPLOAD_ID"
        ],
        "text": "Hello from Siar"
      }
    }
  }'

Snapchat fields

• type string default "STORY"
  One of: STORY SPOTLIGHT SAVED_STORY
• uploadIds string[] nullable
• text string nullable
• title string nullable
• description string nullable
• locale string nullable
• skipSaveToProfile boolean nullable default false
• storyDuration string nullable
  One of: ONE_DAY TWO_DAYS THREE_DAYS ONE_WEEK

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a Snapchat account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• snapchat-profile-api

When Snapchat says no

Siar relays Snapchat's error code and message verbatim on the post, next to a status you can act on. The Snapchat error reference covers 9 common cases with what each one means and the fix. Open the Snapchat error reference.