# GET /accounts

> Botdoorワークスペースに連携済みのSNSアカウントを、投稿先のIDと再連携の状態とともに一覧表示します。

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

連携済みアカウントを一覧表示します。投稿を作成するときは、それぞれの`id`を`accountIds`に指定します。MCPツール：`list_accounts`。

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

## レスポンス `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": []
}
```

| フィールド | 備考 |
|---|---|
| `id` | これを`accountIds`に指定します |
| `platform` | `instagram`、`tiktok`、`facebook`、`twitter`、`linkedin`、`youtube`、`threads`、`bluesky`、`pinterest`、`reddit` |
| `needsReconnection` | SNS側がアクセスを取り消した場合は`true`。再連携するまで、このアカウントへの投稿は失敗します |
| `zernioAccountId` | [connect](https://docs.botdoor.co/ja/api/connect/)に`reconnect`として渡すと、このアカウントを更新できます |
| `removed` | プランの上限を超えて連携されたため、再び連携が解除されたアカウント |
| `next` | 何も連携されていない場合に含まれます。オーナーに何を依頼すべきかを示します |

同じプラットフォームのアカウントを複数連携できます。投稿先はプラットフォームではなく`id`で指定してください。

## よくある質問

### 一覧が空なのはなぜですか？

まだ誰もアカウントを連携していません。未受け取りのワークスペースでは連携できません。ワークスペースを受け取った後、オーナーがbotdoor.co/startでアカウントを連携します。

### needsReconnectionはどういう意味ですか？

SNS側がBotdoorのアクセスを取り消しました。オーナーに「アカウント」から再連携してもらうか、reconnect=<zernioAccountId>を付けて/connectから再連携用のURLを取得してください。

### ボットが自分でアカウントを連携できますか？

いいえ。SNSには人間がログインする必要があります。ボットはURLを取得してオーナーに送ることができます。