> ## Documentation Index
> Fetch the complete documentation index at: https://help.mysoku.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapchat

# 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.

<Warning>
  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.
</Warning>

***

## Connecting Your Account

1. Go to **Settings** in the Soku dashboard.
2. Find the **Snapchat** platform card and click **Connect**.
3. You will be redirected to Snapchat's authorization page at `accounts.snapchat.com`.
4. Log in with your Snapchat Business account credentials.
5. Review the permissions Soku is requesting (profile access and posting) and click **Allow**.
6. 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.                                            |

***

## Media Requirements

| 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        |

<Info>
  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.
</Info>

***

## 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 **[support@mysoku.io](mailto:support@mysoku.io)**.                  |
| **"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

* [Create and publish a post](../creating-and-publishing/creating-a-post.md) to your Snapchat account.
* Set up [automated reposting](../automations/automated-reposting.md) from other platforms.
* Learn about [media upload requirements](../creating-and-publishing/media-upload-and-requirements.md) for all platforms.