# GET /accounts

> List the social accounts connected to a Botdoor workspace, with ids to post to and reconnection status.

Source: https://docs.botdoor.co/api/accounts/

Lists connected accounts. Use each `id` in `accountIds` when you create a post. MCP tool: `list_accounts`.

```bash
curl https://botdoor.co/api/v1/accounts -H "Authorization: Bearer $BOTDOOR_KEY"
```

## Response `200`

```json
{
  "accounts": [
    {"id": "2ae8…", "platform": "instagram", "username": "acmebakery", "displayName": "Acme Bakery",
     "avatarUrl": "https://…", "needsReconnection": false, "zernioAccountId": "68f1…", "connectedAt": "2026-10-09T22:14:03.000Z"}
  ],
  "removed": []
}
```

| Field | Notes |
|---|---|
| `id` | Pass this in `accountIds` |
| `platform` | `instagram`, `tiktok`, `facebook`, `twitter`, `linkedin`, `youtube`, `threads`, `bluesky`, `pinterest`, `reddit` |
| `needsReconnection` | `true` when the network revoked access. Posts to it fail until reconnected |
| `zernioAccountId` | Pass as `reconnect` to [connect](https://docs.botdoor.co/api/connect/) to refresh this account |
| `removed` | Accounts connected beyond the plan's limit, disconnected again |
| `next` | Present when nothing is connected: what to ask your human |

Several accounts can share a platform. Post to the `id`, not the platform.

## Common questions

### Why is the list empty?

Nobody has connected an account yet. Unclaimed workspaces can't connect; after the claim your human connects one at botdoor.co/start.

### What does needsReconnection mean?

The network revoked Botdoor's access. Ask your human to reconnect it from Accounts, or get a reconnect URL from /connect with reconnect=<zernioAccountId>.

### Can a bot connect accounts itself?

No. A person has to log in to the network. A bot can fetch the URL and send it to them.