Connecting Snapchat
Soku connects to Snapchat using the Snapchat Public Profile API via OAuth 2.0. This allows you to post Stories, Spotlights, and Saved Stories directly from Soku.
Prerequisites
Before connecting Snapchat to Soku, make sure you have:
- A Snapchat Business account (not a personal account).
- A Public Profile set up on your Snapchat Business account.
- The ability to log in to Snapchat via a web browser.
Snapchat’s Public Profile API requires a Business account. If you have a personal Snapchat account, you will need to convert it to a Business account or create a new Business account before connecting to Soku.
Connecting Your Account
- Go to Settings in the Soku dashboard.
- Find the Snapchat platform card and click Connect.
- You will be redirected to Snapchat’s authorization page at
accounts.snapchat.com.
- Log in with your Snapchat Business account credentials.
- Review the permissions Soku is requesting (profile access and posting) and click Allow.
- You will be redirected back to Soku. Your Snapchat account will now appear in your integrations list.
Soku stores your Snapchat profile ID, which is required for all posting operations. This is fetched automatically during the authorization process.
Supported Content Types
| Content Type | Supported | Notes |
|---|
| Stories | Yes | 24-hour ephemeral content. Image or video. |
| Spotlights | Yes | Permanent entertainment content. Image or video. Description limited to 160 characters. |
| Saved Stories | Yes | Permanent profile stories. Image or video. Title limited to 45 characters. |
| Text-only posts | No | Snapchat does not support text-only content. |
| Requirement | Specification |
|---|
| Video format | MP4 |
| Video duration | 5 to 300 seconds |
| Minimum resolution | 540 x 960 pixels |
| Maximum file size | 300 MB |
| Image formats | Standard image formats (JPEG, PNG) |
| Aspect ratio | Vertical (9:16) recommended |
Soku automatically encrypts media files with AES-256-CBC encryption before uploading to Snapchat, as required by the Snapchat API. Files larger than 32 MB are automatically split into chunks for upload. This is handled transparently — you do not need to do anything special.
Token Management
- Snapchat OAuth tokens are valid for 60 days.
- Soku automatically refreshes tokens before they expire using a background sweep that runs periodically.
- You can also trigger a manual token refresh from Settings if needed.
- If auto-refresh fails, the account will show a red (Danger) badge in Settings, and you will need to reconnect.
Troubleshooting
| Problem | Solution |
|---|
| ”Invalid scope” or “Unauthorized client” | Verify that you are using a Snapchat Business account with Public Profile API access. |
| ”Invalid redirect_uri” | This is a server configuration issue. Contact support at [email protected]. |
| ”Invalid profile_id” when posting | Try disconnecting and reconnecting your Snapchat account. The profile ID is fetched during authorization. |
| Media upload failed | Verify your media meets the requirements above (format, duration, resolution, file size under 300 MB). |
| ”Forbidden” or “Unauthorized” | Your token may have expired. Check the token status badge in Settings. If it shows red, click Reconnect to re-authorize. |
| Token expired | Tokens last 60 days. Soku auto-refreshes them, but if auto-refresh fails, reconnect your account in Settings. |
| Connection lost after password change | If you change your Snapchat password, you will need to reconnect your account in Soku. |
Next Steps
