# List TikTok accounts

> GET https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes

Group: TikTok. Page: https://www.nabrah.ai/en/docs/api-reference/tiktok/list-tiktok-accounts

List the TikTok accounts connected to the project, oldest first. Each entry includes its `id`, display `name`, `username`, `avatar_url`, whether it needs reconnecting (`disconnected`), `created_at`, and the agent answering on it. Use the returned `id` as the `inbox_id` for the other TikTok endpoints.

## Where inbox IDs come from

This is the canonical source for `inbox_id` values used by the other TikTok endpoints.

- **inboxes[].id**: The UUID of each TikTok account. Pass it as `inbox_id` to the other TikTok endpoints, or as the `{inbox_id}` path parameter to get one account. Fields: `id`, `name`, `username`, `avatar_url`, `created_at`.
- **Answering agent**: The agent auto-replying on the account, or null when none is assigned. Fields: `agent_id`, `agent_name`.
- **disconnected**: True when the account's access was revoked or expired. Replies are not delivered until someone reconnects it from the platform; its conversations and settings are kept. Fields: `disconnected`.
- **max_inboxes**: How many TikTok accounts the project may connect. Contact support to raise it. Fields: `max_inboxes`.

## Connecting accounts

Accounts are connected and reconnected in the platform, because the account owner has to sign in with TikTok in their browser. There is no API for connecting an account.

## Authorization

- `X-API-Key` (string, header, required): your workspace API key.

## Response

### 200 Successful Response

Content type: `application/json`

```json
{
  "inboxes": [
    {
      "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"
    }
  ],
  "max_inboxes": 0
}
```

## Request examples

### cURL

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

### Python

```python
import requests

url = "https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes"
headers = {"X-API-Key": "<your-api-key>"}

response = requests.get(url, headers=headers)
response.raise_for_status()
print(response.json())
```

### JavaScript

```javascript
const response = await fetch("https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes", {
  method: "GET",
  headers: { "X-API-Key": "<your-api-key>" },
});

const data = await response.json();
console.log(data);
```

### Go

```go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes", nil)
	req.Header.Set("X-API-Key", "<your-api-key>")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}
```