Snapchat

Post to Snapchat via API — Stories, Spotlight & Saved Stories

Publish Stories, Spotlight videos, and permanent Saved Stories to Snapchat through a single API endpoint. Schedule snaps, set locale targeting, and cross-post to 12 platforms simultaneously.

Get Started FreeNo credit card required

What you can control via API

Every Snapchat content type and parameter, exposed as first-class API fields.

Stories (24h)snapchat_post_type: STORY

Publish ephemeral Stories that disappear after 24 hours. The default Snapchat format — fast, casual, high-frequency content that drives daily engagement.

Saved Stories (permanent)snapchat_post_type: SAVED_STORY

Pin Stories to your profile permanently. Saved Stories appear in a dedicated section on your public profile — ideal for evergreen content like tutorials or product showcases.

Spotlightsnapchat_post_type: SPOTLIGHT

Submit short-form vertical videos to Snapchat's TikTok-style feed. Spotlight content is surfaced algorithmically to millions of users beyond your follower base.

Locale targetingsnapchat_locale

Set the content locale (e.g. en_US, fr_FR, ar_SA) to target specific language audiences. Snapchat uses this for content distribution and discoverability.

Video attachmentsmedia_urls

Attach MP4 videos between 5 and 300 seconds. Minimum resolution 540x960px (9:16 vertical). CodivUpload handles upload and format validation automatically.

Skip save to profilesnapchat_skip_save_to_profile

When true, the snap is published but not saved to your public profile. Useful for time-sensitive promotions or A/B testing content without cluttering your profile.

Snapchat media requirements

CodivUpload validates these specs before publishing. Invalid media is rejected with a descriptive error.

Format

MP4

H.264 codec

Duration

5 - 300 sec

Min 5s, max 5 min

Resolution

540 x 960px

Minimum (9:16)

Orientation

Vertical

9:16 aspect ratio

API Reference

Snapchat parameters

ParameterTypeRequiredDescription
snapchat_post_typestringOptionalSTORY (default), SAVED_STORY, or SPOTLIGHT. Determines how the content is distributed on Snapchat.
snapchat_descriptionstringOptionalCaption or description for the snap. Used for Spotlight submissions and Saved Story titles.
snapchat_localestringOptionalContent locale in ll_CC format (e.g. en_US, fr_FR). Affects content distribution and audience targeting.
snapchat_skip_save_to_profilebooleanOptionalWhen true, the snap is not saved to your public profile. Default: false.
snapchat_saved_story_titlestringOptionalTitle for Saved Stories. Displayed as the collection name on your public profile. Only used when snapchat_post_type is SAVED_STORY.
SDK Example

Publish with the TypeScript SDK

Install the codivupload package and publish to Snapchat with full type safety.

snapchat-post.ts
import { CodivUpload } from "codivupload";

const codiv = new CodivUpload("YOUR_API_KEY");

const post = await codiv.posts.create({
  profile_name: "my-brand",
  platforms: ["snapchat"],
  post_type: "video",
  description: "Behind the scenes at our studio",
  media_urls: ["https://cdn.example.com/clip.mp4"],
  snapchat_post_type: "SPOTLIGHT",
  snapchat_description: "Studio vibes",
  snapchat_locale: "en_US",
});

// post.id → "post_abc123"
REST API

One request, full Snapchat control

Pass Snapchat parameters alongside your media. CodivUpload validates the payload, queues the job, and handles token refresh.

snapchat-saved-story.sh
# Create a Saved Story on Snapchat
curl -X POST \
  https://api.codivupload.com/v1/posts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "profile_name": "my-brand",
    "platforms": ["snapchat"],
    "post_type": "video",
    "description": "Product demo — spring collection",
    "media_urls": ["https://cdn.example.com/demo.mp4"],
    "snapchat_post_type": "SAVED_STORY",
    "snapchat_saved_story_title": "Spring 2026 Collection",
    "snapchat_locale": "en_US"  }'

Getting Started with Snapchat on CodivUpload

Three steps from zero to your first Snapchat post.

Step 1

Connect your Snapchat account

Open the CodivUpload dashboard, navigate to Integrations, and click Connect Snapchat. Authorize access through Snapchat's OAuth flow. CodivUpload stores tokens encrypted with AES-256-GCM and refreshes them automatically.

Step 2

Choose your content type

Pick between Story (24h ephemeral), Saved Story (permanent profile content), or Spotlight (algorithmic discovery feed). Each type has different distribution mechanics and audience reach.

Step 3

Publish or schedule

Upload your vertical video, set the post type and locale, and publish immediately or schedule for a future date. Cross-post to other platforms in the same request.

Guide: Snapchat API Posting

Deep dive into Stories, Spotlight, Saved Stories, media requirements, and scheduling for Snapchat.

Full API Documentation

Explore every Snapchat parameter, authentication methods, and webhook events in the API reference.

Start posting to Snapchat for free

2 profiles, 10 uploads/mo on the free plan. Upgrade for unlimited.

Get Started Free

Snapchat API questions