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

# List connected accounts

`GET /v1/accounts`

## Request

- Base URL: `https://api.letmepost.dev`
- URL: `https://api.letmepost.dev/v1/accounts`
- Auth: HTTP bearer

Lists every connected platform account in the caller's organization. No secrets ever leak — display name, platform identifiers, and lifecycle timestamps only.

## Query parameters

- `profileId` string

## Response `200`

Connected accounts.

- AccountListResponse
  - `data` Account[], required
    - `id` string, uuid, required
    - `profileId` string, uuid, required
    - `platform` 'bluesky' | 'facebook' | 'instagram' | 'linkedin' | 'pinterest' | 'threads' | 'tiktok' | 'twitter', required: Supported platforms. `tiktok` posts upload to the creator's TikTok inbox as a draft that the creator confirms in the TikTok app; Direct Post is not implemented yet.
    - `platformAccountId` string, required: The platform's own user/account id (e.g. Twitter user id, IG Business id).
    - `displayName` string, nullable, required
    - `tokenExpiresAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `pinterest` object: Pinterest-only metadata block.
      - `defaultBoardId` string, nullable
      - `defaultBoardName` string, nullable
    - `instagram` object: Instagram-only metadata block. `accountType` and `grantedScopes` echo what Meta reports.
      - `kind` string, nullable
      - `accountType` string, nullable
      - `grantedScopes` string[], nullable

## Other responses

- `401`: `unauthenticated` — missing or invalid Bearer key.
- `429`: `rate_limited` — too many requests. Inspect `X-RateLimit-Limit` (static ceiling) and the IETF-draft `RateLimit-*` headers (sliding-window remaining/reset) before retrying.

---

[API](https://skmtc.dev/letmepost/apis/letmepost-dev-api.md) · [All operations](https://skmtc.dev/letmepost/apis/letmepost-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letmepost/apis/letmepost-dev-api/revisions/f6659001f96b?raw)