tebarDocs
GuideDevelopersAPI ReferenceChangelog
Accounts

Get an account

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

Tebar-Profile?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.

Example Request
curl -X GET 'https://api.tebar.app/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
}