# List Instagram accounts

`GET https://app.whatsetter.com/api/v1/instagram/accounts`

The workspace's connected Instagram accounts: the `id` every
Instagram route takes as `account_id`, the `status` (`connected`, or
`needs_reconnect` when the connection expired or was revoked), what
each account may do (`grants`: messages, publishing, insights; an
account connected before publishing and insights were offered must
be reconnected from the dashboard for them), the Facebook Page linked to
it and whether that Page allows publishing, its agent (the
`campaign_id` that answers, whether it is on, whether it answers
every private message or only the people an automation brought), « Le
tri » (when the agent answers every private message: which messages
it answers anyway) and `human_pause_hours` (how long a person's reply
pauses the agent on a lead; 0 = never). No token is ever returned.
Requires scope `instagram:read`.

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/instagram/accounts' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The connected accounts

```json
{
  "data": [
    {
      "id": "68f1c2d3e4f5a6b7c8d9e0f1",
      "username": "acme.studio",
      "name": "Acme Studio",
      "status": "connected",
      "grants": {
        "messages": true,
        "publish": true,
        "insights": true
      },
      "facebook_page": {
        "name": "Acme Studio",
        "can_publish": true
      },
      "agent": {
        "campaign_id": "instagram-acme-studio-x7k2",
        "enabled": true,
        "all_dms": true
      },
      "triage": {
        "enabled": true,
        "answer_collab": false,
        "answer_support": false,
        "answer_personal": false
      },
      "human_pause_hours": 24
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listinstagramaccounts/
