Get account

GET /accounts/:id

Returns detailed information about a specific connected social media account, including its health status and whether it can currently post.

Round-trip safe

The account_id returned here is the same value you pass into POST /v1/posts as part of the account_ids array. Same field name on both sides of the request/response boundary.

Check health.can_post before posting

If health.can_post is false, the account's OAuth token has expired or the account has been flagged by the platform. Posts queued against an unhealthy account will fail immediately with a token-expired error. The account owner needs to reconnect via the PostEverywhere web app before posting resumes.

Path Parameters

Parameter	Type	Required	Description
`account_id`	integer	Yes	The account's ID. Accepts `id` as a deprecated alias in the URL path.

Response Example

200 — Account details

{
  "data": {
    "account_id": 2280,
    "platform": "instagram",
    "account_name": "@mybrand",
    "avatar_url": "https://example.com/avatar.jpg",
    "is_active": true,
    "created_at": "2026-01-15T10:00:00.000Z",
    "health": {
      "status": "healthy",
      "can_post": true
    }
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Response fields

Field	Type	Description
`account_id`	integer	Canonical account identifier (use in `account_ids` when creating posts)
`platform`	string	`x`, `instagram`, `facebook`, `linkedin`, `youtube`, `tiktok`, `threads`, or `pinterest`
`account_name`	string	Display name or username on the platform
`avatar_url`	string or null	Profile picture URL
`is_active`	boolean	Whether the account is active
`created_at`	string (ISO 8601)	UTC timestamp when the account was connected
`health.status`	string	`healthy`, `expired`, or `unhealthy`
`health.can_post`	boolean	Whether the account can currently publish posts

Request

Responses

Account details

Get account

/accounts/:id

Path Parameters​

Response Example​

200 — Account details​

Response fields​

Request​

Responses​