socifyr connections
socifyr connections lists the accounts connected to your workspace with the slug you pass to --to when posting. Two subcommands fix expired accounts without opening the dashboard.
socifyr connections [--json]
socifyr connections refresh <slug>
socifyr connections reconnect <slug> [--json]conn is an alias for connections. Slugs, statuses and refresh rules are explained in Connections and slugs.
How do I list my connected accounts and slugs?
socifyr connections3 connected accounts:
instagram-mybrand
instagram · mybrand
x-myhandle
x · myhandle
✗ Needs reconnect — run: socifyr connections reconnect x-myhandle
linkedin-myhandle
linkedin · Madhav Poudel
⚠ Expiring — run: socifyr connections refresh linkedin-myhandle
Use slugs with: socifyr post "text" --to <slug1,slug2>In a real terminal each account also gets an icon before its slug. The second line is the platform and the account or page name. Disconnected accounts are not listed. With no accounts the CLI points you to the dashboard integrations page.
| Flag | Description |
|---|---|
--json | Print the active connections as a JSON array |
socifyr connections --json | jq '.[] | {slug, status, canRefresh, expiresAt}'{
"slug": "linkedin-myhandle",
"status": "expiring",
"canRefresh": true,
"expiresAt": "2026-11-18T10:00:00.000Z"
}What do the connection statuses mean?
status | Meaning | CLI hint | Fix |
|---|---|---|---|
active | Token is healthy | none | none |
expiring | Token is close to expiring | Expiring — run: socifyr connections refresh <slug> when canRefresh is true | Refresh it |
needs_reconnect | Only a fresh authorization fixes it | Needs reconnect — run: socifyr connections reconnect <slug> | Reconnect it |
An expiring account with canRefresh: false gets a Token expires <date> warning when the expiry is less than 7 days away.
How do I refresh an expiring account?
socifyr connections refresh linkedin-myhandle
# ✓ Refreshed linkedin-myhandle · status: activeThis renews the token with the stored refresh token and needs no action from the account owner. If the platform cannot refresh, or the refresh token is dead, the command exits with code 1 and prints Try: socifyr connections reconnect <slug>.
How do I reconnect an account that needs reconnect?
socifyr connections reconnect x-myhandleReconnect x-myhandle (x)
Open this link in a browser and approve access:
https://api.socifyr.com/api/oauth/x/connect-popup?code=...
Sign in with the same account. Works once; expires in 10 minutes. Your slug and scheduled posts are kept.The link is single use. Approving the same account updates the existing connection in place, so the slug and scheduled posts stay. Approving a different account creates a new connection instead. Only the workspace owner can request the link; anyone else gets Only the workspace owner can connect accounts.
--json prints the raw result:
{
"url": "https://api.socifyr.com/api/oauth/x/connect-popup?code=...",
"expiresIn": 600,
"platform": "x",
"slug": "x-myhandle"
}After the owner approves, retry the failed post with socifyr retry.
How do I connect a brand-new account?
Not from the CLI. New connections go through the platform's authorization page, which the dashboard opens. See Connections and slugs.