TikTok

Get TikTok account

Retrieve one of the project's TikTok accounts by its id: id, name, username, avatar_url, disconnected, created_at, and the agent answering on it (agent_id and agent_name, null when none).

GET

https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes/{inbox_id}

Get TikTok account

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes/<inbox_id>' \
  --header 'X-API-Key: <your-api-key>'

{
  "id": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "created_at": "2026-01-15T12:00:00.000Z",
  "username": "string",
  "avatar_url": "string",
  "disconnected": false,
  "agent_id": "00000000-0000-4000-8000-000000000000",
  "agent_name": "string"
}

Where the inbox_id comes from

Obtain the inbox_id from the account list endpoint.

Call GET /api/ext/omni_v2/tiktok/inboxes and use any returned inboxes[].id value.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

inbox_idstringrequired

The UUID of the TikTok account to fetch.

Get this value from GET /api/ext/omni_v2/tiktok/inboxes (the inboxes[].id field).

Response

200

Successful Response

application/json

422

Validation Error

application/json