/api/v2/accountsGETLists the social accounts connected to your workspace. Each
workspace holds at most one account per platform. Use an
account's
id as accountId when creating posts.Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Response
200
total *number
Number of connected accounts
accounts *object[]
Connected social accounts, one per platform
Show item properties
id *string
Account ID — use as
accountId when creating postsplatform *"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
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