Before you connect
Connecting has two parts. Someone who runs the server creates an app in that network’s developer portal and puts the client id and secret in the server environment. Then an owner or admin opens Accounts or Settings, chooses the brand, and presses Connect.
Connect opens the network’s own sign-in. You approve the requested permissions and come back. The token is stored encrypted for that brand. It is bound to the workspace, the brand, and the account, so a copied row does not decrypt under a different brand. The product never shows the token again.
The return address
Section titled “The return address”The network sends the person back to:
{APP_PUBLIC_ORIGIN}/api/connect/{network}/callbackAccounts prints the exact address the running server will use. Register that string, character for character. The return link expires after 10 minutes, works once, and has to be finished by the same signed-in person who pressed Connect.
With the local web app, the origin is http://127.0.0.1:5173. TikTok’s web sign-in refuses a local http address. Use an https origin before you register TikTok.
What every network refuses
Section titled “What every network refuses”- The product does not automate the social website.
- Comments and mentions are fetched only where the official API and this connection allow it. Direct messages are included only when that API is part of the connection. See Inbox and listening.
- A channel already connected to another brand in the same workspace cannot be connected again until it is disconnected.
- If the developer app is unfinished, Connect stays visible and the card says the missing step in plain language, including the redirect URI to register.
Official limits, in short
Section titled “Official limits, in short”| Network | Posts through the API | Does not post through the API |
|---|---|---|
| YouTube | Videos and Shorts, via videos.insert |
Community posts |
| TikTok | Direct video posts. Inbox upload hands the file to the creator. | Photo posts, comments, and anything that is not a video |
| X | Text, images, GIF, video, threads, replies. Quotes on Enterprise. | Website-only features, and quotes on pay-per-use |
| Image, Reel, carousel, for a professional account | Personal accounts, direct messages, comments | |
| Text, images, video, link cards, as a member or an approved Company Page | Newsletter editions | |
| Blog | A markdown file in the configured GitHub repository | A hosted blog that is not that repository |
Handoff posts are explained on Handoff-only posts.