mulaichatDocs
GuidesDeveloperAPI ReferenceChangelog
Accounts
GET
/v1/accounts/{id}

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

mulaichat-workspace?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

The account.

application/json
  1. response
id*string
Formatuuid
profile_id*string
Formatuuid
platform*string
Value in"threads""instagram""facebook""tiktok""linkedin""youtube""x""telegram""discord""pinterest"
username*string|null
display_name*string|null
avatar_url*string|null
status*string
Value in"active""expired""revoked"
scopes*array<string>

Platform permissions granted for this account.

token_expires_at*|null
connected_at*string
Formatdate-time
plan_suspended*boolean

Over the plan account limit: still connected, but no posting until reactivated.

expired_at*|

When the account became expired; null while active.

expired_reason*|

Why it became expired: the platform's message (e.g. a revoked token) or Mulaichat's reason. Null while active.

Example Request
curl -X GET 'https://api.mulaichat.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",  "platform": "threads",  "username": "string",  "display_name": "string",  "avatar_url": "string",  "status": "active",  "scopes": [    "string"  ],  "token_expires_at": "2019-08-24T14:15:22Z",  "connected_at": "2019-08-24T14:15:22Z",  "plan_suspended": true,  "expired_at": "2019-08-24T14:15:22Z",  "expired_reason": "string"}

On this page