Skip to content

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.

bash
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? ​

bash
socifyr connections
3 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.

FlagDescription
--jsonPrint the active connections as a JSON array
bash
socifyr connections --json | jq '.[] | {slug, status, canRefresh, expiresAt}'
json
{
  "slug": "linkedin-myhandle",
  "status": "expiring",
  "canRefresh": true,
  "expiresAt": "2026-11-18T10:00:00.000Z"
}

What do the connection statuses mean? ​

statusMeaningCLI hintFix
activeToken is healthynonenone
expiringToken is close to expiringExpiring — run: socifyr connections refresh <slug> when canRefresh is trueRefresh it
needs_reconnectOnly a fresh authorization fixes itNeeds 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? ​

bash
socifyr connections refresh linkedin-myhandle
# ✓ Refreshed linkedin-myhandle · status: active

This 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? ​

bash
socifyr connections reconnect x-myhandle
Reconnect 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:

json
{
  "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.

Next steps ​