---
title: "List connected accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List connected accounts

`GET /accounts`

## Request

- Base URL: `https://social-automation.cresclab.com/api/v1`
- URL: `https://social-automation.cresclab.com/api/v1/accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cresclab/apis/social-automation-api/docs/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- object
  - `accounts` Account[]
    - `id` string
    - `platform` 'instagram' | 'facebook' | 'threads'
    - `handle` string
    - `username` string, nullable
    - `page_name` string, nullable
    - `supported_triggers` Trigger[]
    - `token_expires_at` string, nullable
    - `connected_at` string
  - `connect_url` string

## Other responses

- `400`: Invalid request (see error.field)
- `401`: Missing or invalid API key
- `403`: Insufficient scope, trial expired, contract expired or plan limit (see error.code and error.action_url)
- `429`: Rate limited

---

[API](https://skmtc.dev/cresclab/apis/social-automation-api.md) - [All operations](https://skmtc.dev/cresclab/apis/social-automation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cresclab/apis/social-automation-api/revisions/1d4ea62ba46d?raw)