---
title: "Fetch a connected account"
method: GET
path: "/v1/accounts/{id}"
tags: ["Accounts"]
---

# Fetch a connected account

`GET /v1/accounts/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Account detail.

- Account: A connected platform account. Secrets never leak — only display name, platform identifiers, and lifecycle timestamps. Platform-specific extension blocks (e.g. `pinterest`, `instagram`) carry non-sensitive metadata.
  - `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.
- `404`: `not_found` — the resource does not exist in the caller's organization (or, for profile-scoped keys, in the caller's profile).
- `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)