Workspaces and accounts

List Workspaces

postlybee workspaces:list

The result contains only Workspaces allowed by the Token and current OWNER/MANAGER membership.

[
  {
    "id": "4cb8c6af-7111-4e5d-a7cd-846c9293d4c1",
    "name": "PostlyBee",
    "type": "PERSONAL",
    "timezone": "Asia/Shanghai"
  }
]

Select a Workspace globally:

export POSTLYBEE_WORKSPACE_ID="4cb8c6af-7111-4e5d-a7cd-846c9293d4c1"

Or for one command:

postlybee accounts:list --workspace 4cb8c6af-7111-4e5d-a7cd-846c9293d4c1

List connected accounts

postlybee accounts:list

Use the returned account id for posting, analytics, settings, and posting-slot commands. Provider names and profile URLs are not account IDs.

Connect an account

postlybee accounts:connect x
postlybee accounts:connect mastodon --external-url https://social.example.com

The CLI returns an OAuth URL as JSON. Open it in a browser to authorize the provider. Reconnect an existing provider identity with --refresh <accountId>.

Provider settings

postlybee accounts:settings ACCOUNT_ID

The response includes platform rules, maximum content length, provider settings schema, and discovery tools. Trigger one of the advertised tools:

postlybee accounts:trigger ACCOUNT_ID getBoards \
  --data '{"query":"product"}'

Discovery tools can return Pinterest boards, Reddit flairs, YouTube playlists, LinkedIn companies, or other provider-specific data.

Delete an account

postlybee accounts:delete ACCOUNT_ID

This disconnects the account, stops its refresh workflow, and deletes its pending posts. The command intentionally has no interactive confirmation so automated scripts remain deterministic; confirm the target ID in your own workflow before executing it.

Get started

Essentials

MCP

CLI

SDKs

API reference

Workspaces and accounts

List Workspaces

List connected accounts

Connect an account

Provider settings

Delete an account

​List Workspaces

​List connected accounts

​Connect an account

​Provider settings

​Delete an account

List Workspaces

List connected accounts

Connect an account

Provider settings

Delete an account