Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Connecting Accounts

Akarso supports 10 social platforms. Each account connects through an OAuth flow in your browser.
Each workspace holds one account per platform, so commands address accounts by platform name (x, linkedin, googlebusiness, ...) instead of account IDs. Connecting a platform that is already connected replaces the existing account.
Connecting accounts does not require a subscription. Without one you can connect up to 3 accounts; subscribing raises the limit based on your plan.

Connect via CLI

The simplest way to connect is the interactive command:
akarso accounts connect
This prompts you to pick a platform and opens the browser. If you know which platform:
akarso accounts connect x

How the OAuth flow works

  CLI                        Browser                     Akarso
   │                            │                           │
   ├── opens connect URL ──────►│                           │
   │                            ├── user authorizes ───────►│
   │                            │                           │
   │                            │◄── redirect to callback ──┤
   │                            │                           │
   │                            ├── picks an account ──────►│
   │                            │   (only when one          │
   │                            │    authorization grants   │
   │                            │    several)               │
   ▼                            ▼                           ▼
  Done                   "Connected" page             Account saved
  1. The CLI builds a connect URL for your workspace
  2. Your browser opens the OAuth page for the chosen platform
  3. You authorize Akarso to access your account
  4. The platform redirects back to the Akarso callback page
  5. The account is connected and ready to use

Picking an account

One authorization can grant several publishing targets. LinkedIn hands over your personal profile and every company page you administer; Facebook hands over every Page you administer.
When that happens, akarso.co asks you which one to connect — the whole choice stays on the Akarso callback page, and only the account you pick is connected. Each workspace publishes to one account per platform.
If a different account for the same platform was already connected, the callback also asks which of the two to keep. The other one is disconnected from Akarso, never deleted on the platform itself.
To switch to a different page or profile later, connect the platform again and pick it.

Bluesky

Bluesky has no browser OAuth. Instead, the connect page asks for your handle and an app password:
akarso accounts connect bluesky
Generate an app password at bsky.app/settings/app-passwords — never use your account password.

List connected accounts

akarso accounts list

Get account details

Accounts are addressed by platform name:
akarso accounts get facebook

Pinterest boards

Pinterest pins always target a board. List the connected account's boards to find the ID for posts create --pinterest-board:
akarso accounts pinterest-boards

Disconnect an account

akarso accounts disconnect x
If posting to a platform starts failing with authorization errors (expired or revoked tokens), reconnect it with akarso accounts connect.
Powered byHolocron