Snapchat API Error Reference

Solution:

Your Snapchat access token has expired or been revoked. Snapchat tokens expire after 1 hour. Go to your account settings and reconnect your Snapchat Public Profile.

Solution:

Your Snapchat session has expired. This typically happens after the 1-hour token lifetime or if you changed your Snapchat password. Reconnect your Snapchat Public Profile to establish a new session.

Solution:

Your access token was revoked, either by you removing the app from your Snapchat settings or by Snapchat security systems. You must reconnect your Snapchat Public Profile.

Solution:

The app needs the snapchat-profile-api permission. Make sure you grant all required permissions when reconnecting. Note that Snapchat's Public Profile API is allowlist-only.

Solution:

Snapchat requires a Public Profile to publish content via API. Create a Public Profile in the Snapchat app: go to your profile > tap the gear icon > Create Public Profile. Then reconnect your account.

Solution:

The Public Profile ID stored for your account is no longer valid. This can happen if you deleted your Public Profile. Create a new Public Profile in Snapchat and reconnect your account.

Solution:

Your Snapchat Public Profile has been suspended for violating community guidelines. Review Snapchat's Community Guidelines and appeal the suspension through the Snapchat app.

Solution:

Snapchat Stories and Spotlight only accept image (JPG, PNG) and video (MP4) formats. Convert your media to a supported format before uploading.

Solution:

Snapchat has file size limits: images should be under 5MB and videos under 1GB. Compress your media or use a shorter video clip.

Solution:

The media upload to Snapchat failed. This is usually a temporary issue. Wait a few moments and try again. If the problem persists, check your media file for corruption.

Solution:

Snapchat Stories have a maximum video length of 60 seconds, while Spotlight allows up to 60 seconds. Trim your video to meet these requirements.

Solution:

Snapchat prefers 9:16 vertical content. While other ratios may work, vertical content performs best. Resize your media to 1080x1920 pixels for optimal results.

Solution:

Snapchat has rate limits to prevent spam. Wait a few minutes before attempting to post again. If you're scheduling multiple posts, space them out more.

Solution:

You've exceeded Snapchat's API rate limits. Wait 15-60 minutes before making more requests. Consider implementing exponential backoff in your integration.

Solution:

Your content has been flagged for violating Snapchat's Community Guidelines. Review the guidelines at support.snapchat.com and modify your content to comply.

Solution:

Snapchat's systems detected your content as potential spam. Avoid repetitive posts, excessive links, or promotional content that looks automated.

Solution:

Your content may contain copyrighted material. Use original content or ensure you have proper licensing for any third-party content.

Solution:

Snapchat's servers are experiencing issues. Wait a few minutes and try again. If the problem persists, check Snapchat's status page.

Solution:

This is a temporary Snapchat service issue. Wait a few minutes before retrying your request. The system will automatically retry for you.

Solution:

The request to Snapchat took too long to complete. This is usually temporary. Try again with a smaller media file or wait for Snapchat's systems to recover.