Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
/api/v2/accounts/blueskyPOST
Connects a Bluesky account using an app password (Bluesky has no browser OAuth). Generate one at https://bsky.app/settings/app-passwords — never use your account password. Returns the connected account.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Request Bodyapplication/jsonrequired
identifier *string
Bluesky handle (e.g. "alice.bsky.social") or DID (e.g. "did:plc:abc123")
Min length: 1
password *string
An app password generated at https://bsky.app/settings/app-passwords. Never your account password.
Min length: 1
Response
200
id *string
Account ID — use as accountId when creating posts
platform *"twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
Platform of this account
platformUserId?string | null
Native user ID on the platform
username?string | null
Public username or handle
displayName?string | null
profileUrl?string | null
Public profile/page URL, when known
imageUrl?string | null
Profile picture URL, if the platform provides one
createdAt?string | null
ISO time the account was connected
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
403
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
limit?number
The plan limit that was hit
used?number
Current usage in this billing period
connected?number
Currently connected accounts
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
Request example
curl -X POST "https://akarso.co/api/v2/accounts/bluesky" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "identifier": "string", "password": "string" }'