Connect social accounts in the dashboard
Open Accounts in the sidebar, find the platform under Add an account, and click Connect. Most platforms open an authorization popup. Bluesky, Telegram, Discord, Mastodon, Nostr, Slack, Dev.to, Hashnode, and Tumblr open a form where you paste a token or password instead.
Only the workspace Owner can connect or disconnect accounts. Admins, Editors, and Contributors can view them. See roles.
How do I connect an account with OAuth?
Platforms that use OAuth: Instagram, Facebook, YouTube, X, LinkedIn, TikTok, Threads, Pinterest, and Reddit.
- Go to Accounts.
- Under Add an account, click Connect on the platform tile. Use Search platforms... to filter.
- A popup opens. Allow popups for the site if your browser blocks it. Socifyr shows a "Popup blocked" message if it is blocked.
- Sign in to the platform and approve access.
- The popup closes and a toast says "<Platform> connected". The account moves up into the Connected section.
Facebook is connected through your Page. A linked Instagram business account connects automatically at the same time.
The page shows how many accounts you have against your plan, for example 2 / 3 accounts connected. At the limit it says "limit reached" and the Add an account section tells you to upgrade. Reconnecting an existing account is never blocked by the limit. See Usage and billing.
How do I connect Telegram, Discord, Mastodon, Nostr, Slack, Bluesky, Dev.to, Hashnode, or Tumblr?
These platforms do not use an OAuth review. Click Connect and the popup shows a form. Socifyr validates what you paste against the platform before it saves the connection.
| Platform | You paste | Where to get it |
|---|---|---|
| Bluesky | Your handle (for example user.bsky.social) and an app password | Bluesky Settings, Privacy and Security, App Passwords |
| Telegram | Bot token and the chat or channel ID (or @username) | @BotFather; the bot must be an admin of the target channel |
| Discord | Webhook URL | Channel, Edit, Integrations, Webhooks, New Webhook, Copy URL |
| Mastodon | Instance URL and an access token | Preferences, Development, New Application (read and write scopes) |
| Nostr | Private key (nsec... or 64-character hex) and optional comma-separated relays | Your Nostr client. Use a dedicated key. |
| Slack | Incoming webhook URL | slack.com/apps, Incoming WebHooks |
| Dev.to | API key | Dev.to Settings, Extensions, DEV Community API Keys |
| Hashnode | Personal Access Token | Hashnode Settings, Developer |
| Tumblr | Consumer key, consumer secret, OAuth token, OAuth token secret | Your app at tumblr.com/oauth/apps |
Secrets are encrypted at rest. Nostr and Slack are text only. Hashnode posts to your first publication. Details per platform are on the platform pages.
What can I do with a connected account?
Each platform card lists its accounts. Each row shows the handle, a slug chip, and token health.
- Copy the slug. Click the chip (title "Copy connection ID") to copy a slug like
instagram-mybrand. Slugs are what the CLI, SDK, API, and MCP use. See Connections and slugs. - Add another account on the same platform with Add account, or Connect another <Platform> login.
- Pick Pages or accounts (Meta only). Facebook and Instagram expose extra Pages and business accounts. Choose them from the dropdown; ones already added show "Added".
- Refresh token. In the row menu, for platforms that support it (YouTube, X, TikTok, Pinterest, Reddit, Bluesky).
- Disconnect. Keeps the account authorized on the platform so you can reconnect later.
- Remove. On a disconnected account, deletes it from your workspace.
- Bulk actions. Tick several rows to Disconnect, Reconnect, or Remove them together.
- Reload re-fetches the list.
How do I connect an account without the dashboard?
You cannot start the first connection from code, because OAuth and credential forms need a browser. After that, reconnect_connection / socifyr connections reconnect <slug> give you a link for re-authorizing an existing account. See Reconnect an expired account.
Common problems
| Symptom | Fix |
|---|---|
| "Popup blocked" | Allow popups for the Socifyr site and click Connect again. |
| "Could not start the connection" | Try again. The popup code is valid for 60 seconds and works once. |
| "<Platform> connection failed" | Read the description in the toast. Often the platform denied a permission. Retry and approve every permission. |
| Limit reached | Disconnect and remove an account you do not use, or upgrade. |
| Bluesky rejects your password | Use an app password, not your account password. |
| Telegram fails validation | Make the bot an admin of the channel, then paste the chat ID again. |