Skip to main content
SNAPCHAT SUPPORT USES THE PUBLIC PROFILE API. THE CONNECTED SNAPCHAT ACCOUNT MUST HAVE A PUBLIC PROFILE THAT THE AUTHORIZING USER CAN MANAGE.

​
Supported Content Types

  • Public Stories with one image or MP4 video.
  • Spotlights with one MP4 video.
  • Profile, Story, and Spotlight analytics.
Snapchat does not require a separate set-channel call. The Public Profile returned during OAuth becomes the publishing target.

​
Post Options

FieldTypeDescription
typeSTORY | SPOTLIGHTDefaults to STORY.
uploadIdsstring[]Required. Exactly one uploaded media file.
descriptionstringSpotlight description, max 160 characters.
textstringAlias for Spotlight description, max 160 characters. description takes precedence.
localestringSpotlight locale in en_US format. Defaults to en_US.
skipSaveToProfilebooleanSpotlight only. Ask Snapchat not to save the Spotlight to the Public Profile. Defaults to false.

​
Story Example

{
  "teamId": "team_123",
  "title": "Launch Story",
  "status": "SCHEDULED",
  "postDate": "2026-07-20T15:00:00.000Z",
  "socialAccountTypes": ["SNAPCHAT"],
  "data": {
    "SNAPCHAT": {
      "type": "STORY",
      "uploadIds": ["upload_image_123"]
    }
  }
}

​
Spotlight Example

{
  "teamId": "team_123",
  "title": "Launch Spotlight",
  "status": "SCHEDULED",
  "postDate": "2026-07-20T15:00:00.000Z",
  "socialAccountTypes": ["SNAPCHAT"],
  "data": {
    "SNAPCHAT": {
      "type": "SPOTLIGHT",
      "uploadIds": ["upload_video_123"],
      "description": "A quick look at what we shipped",
      "locale": "en_US",
      "skipSaveToProfile": false
    }
  }
}

​
Media Limits

​
Stories

ConstraintValue
FilesExactly 1 image or MP4 video
Max file size100 MB
Video minimum resolution540x960
Video duration5-60 seconds

​
Spotlights

ConstraintValue
FilesExactly 1 MP4 video
Max file size100 MB
Minimum resolution540x960
Video duration6-60 seconds

​
Publishing Behavior

Snapchat processes uploaded media asynchronously. A post can remain in PROCESSING while Snapchat prepares the asset. bundle.social polls the media state and finalizes the Story or Spotlight when it becomes ready. The post response stores Snapchat progress in externalData.SNAPCHAT, including mediaId, content type, Public Profile ID, source upload ID, and one of these statuses:
  • MEDIA_UPLOADED
  • MEDIA_PROCESSING
  • PUBLISHED

​
Analytics

​
Profile Analytics

MetricSnapchat source
impressions, viewsCombined profile, Story, saved Story, Spotlight, and Lens views returned by Snapchat
impressionsUnique, viewsUniqueUnique sessions/viewers where available; falls back to views
likesFavorites/likes across supported profile content
commentsReplies/comments
postCountStory, saved Story, Spotlight, and Lens content counts where available
followersSubscribers/followers
followingReturns 0

​
Story And Spotlight Analytics

Post analytics use Snapchat lifetime stats and map views, unique viewers, favorites, replies, shares, and screenshots into the standard post analytics fields. Raw Snapchat analytics can be enabled per organization. Contact us if you need the original Snapchat stats payload alongside normalized metrics.