Connecting Accounts

Akarso supports 14 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 channels; subscribing raises the limit to your plan's channel count.

Ask AI about this page

Connect via CLI

The simplest way to connect is the interactive command:

1akarso accounts connect

This prompts you to pick a platform and opens the browser. If you know which platform:

1akarso accounts connect x

How the OAuth flow works

  CLI                        Browser                     Akarso
   │                            │                           │
   ├── opens connect URL ──────>│                           │
   │                            ├── user authorizes ───────>│
   │                            │                           │
   │                            │<── redirect to callback ──┤
   │                            │                           │
   v                            v                           v
  Done                   "Connected" page             Account saved
                       (+ channel picker on
                        some platforms)

The CLI builds a connect URL for your workspace
Your browser opens the OAuth page for the chosen platform
You authorize Akarso to access your account
The platform redirects back to the Akarso callback page
On some platforms the callback page asks you to pick a publishing target (see below)
The account is connected and ready to use

Channel selection

Some platforms hold multiple publishing targets under one login: Facebook Pages, LinkedIn organizations, YouTube channels, Google Business locations. After OAuth, these platforms need a channel selected before posting works:

Platform	Publishing target
Facebook	Page
Instagram	Instagram account (connected via Facebook)
LinkedIn	Organization or personal profile
YouTube	Channel
Google Business	Location

The connect flow shows the picker automatically in the browser. You can also pick from the CLI: list the selectable channels with accounts get, then set one:

12akarso accounts get facebook
akarso accounts set-channel facebook --channel-id page_123

Posting to these platforms fails until a channel is selected.

List connected accounts

1akarso accounts list

Check account health

Token health tells you if any connected accounts have expired or revoked tokens:

1akarso accounts health

Accounts with unhealthy tokens need to be reconnected using akarso accounts connect.

Get account details

Accounts are addressed by platform name. The output includes the selectable channels:

1akarso accounts get facebook

Disconnect an account

1akarso accounts disconnect x