OAuth & connect
Fix platform connection errors — invalid state, grants, popups, and per-platform requirements.
Overview
Connecting a social account always happens in the dashboard (or the platform’s OAuth screen opened from it). The CLI and MCP can list accounts and publish to connected accounts; they cannot complete platform OAuth for you. Use Dashboard → Connections (or social0 accounts connect <platform> which opens the dashboard link).
Guide: Connecting accounts.
Common connection errors
| Symptom | Likely cause | Fix |
|---|---|---|
invalid_state or "state mismatch" | Tab sat open too long, back button, or multiple connect tabs | Close extra tabs. Start Connect again from Connections |
invalid_grant / token expired | Platform revoked or expired the token | Disconnect the account in Social0, then Connect and sign in again |
fetch failed / network error | Ad blocker, VPN, or platform outage | Disable blockers for social0.app and the platform domain; retry on a stable network |
| Blank popup or immediate close | Popup blocked | Allow popups for social0.app; retry connect |
| Connect succeeds but account missing | Wrong Facebook Page / Instagram link | See platform sections below |
| "Expired" on Connections list | Refresh token failed | Disconnect and reconnect that account |
Reconnect flow (works for most platforms)
- Dashboard → Connections
- Disconnect the broken account (note: you may need a free slot — see Account limits)
- Connect again and complete the platform sign-in
- Create a test post to one account before multi-platform jobs
Platform-specific requirements
Social0 supports two connect paths:
- Direct Instagram OAuth — sign in with Instagram (Business/Creator accounts).
- Via Facebook Page — pick a Facebook Page linked to your Instagram account, then select the Instagram account.
If you use the via Facebook Page path and connect fails or the wrong account appears, the Instagram account may not be linked to the Page you chose. Fix the link on Meta first, then reconnect in Social0.
Bluesky
Bluesky uses your handle + app password (BYOK), not OAuth in a browser popup.
- Create an app password in Bluesky Settings → App passwords
- Enter handle and app password in the Social0 connect form
- Details: Bluesky
Meta (Facebook / Instagram)
Meta OAuth requires HTTPS on the redirect URL. social0.app uses HTTPS by default.
TikTok, LinkedIn, Pinterest, others
Each platform has its own consent screen. See Platforms for limits and tips.
Pinterest: You may need to pick a board during connect or when creating a pin. Pinterest
CLI and MCP
- CLI:
social0 accounts connect <platform>opens the dashboard connect flow — it does not embed OAuth in the terminal. - MCP: Connect accounts in the dashboard first, then use
list_accountsin the connector. See MCP troubleshooting.
Never paste platform passwords into CLI/MCP chat unless the product explicitly asks (Bluesky app password is entered only in the dashboard connect UI).
Tips
- Connect one platform at a time when debugging.
- If you changed your password on the platform, reconnect in Social0.
- Multiple accounts on the same network (e.g. two LinkedIn pages) each need a separate connect; use numeric account IDs in API/CLI when names are ambiguous.