PostZen
Accounts

List accounts

GET
/v1/accounts

Returns connected social accounts available to the API key, sorted by connection date (newest first). Read-only and read-write API keys are accepted.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Query Parameters

profileId?string

Filter accounts by profile id.

platform?string

Filter accounts by platform. twitter is accepted as an alias for x.

status?string

connected returns healthy accounts. disconnected returns accounts that need reconnection or are disabled.

page?integer

1-based page number. Must be provided with limit.

limit?integer

Page size. Must be provided with page.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts"
{  "accounts": [    {      "_id": "j97kp4mw2xnv6r1t8c3zq5bs9fh0yg4d",      "platform": "twitter",      "providerAccountId": "1934567890123456789",      "profileId": {        "_id": "jh72r5nqk9wx3v8m1t4cz6bs0fy5dg3e",        "name": "Marketing Team",        "slug": "marketing-team",        "color": "#4caf50"      },      "username": "acme",      "displayName": "Acme",      "profileUrl": "https://x.com/acme",      "status": "connected",      "isActive": true,      "connectedAt": "2026-06-13T16:00:00.000Z"    }  ]}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "API key requires read_write permission"}
{  "error": "Not found"}
{  "error": "Failed to create post"}

Delete a profile DELETE

Deletes a profile. The default profile cannot be deleted, and profiles with connected accounts must be disconnected first.

Disconnect an account DELETE

Disconnects and removes a connected social account. Pending scheduled, queued, and publishing targets for that account are canceled. This endpoint requires a read-write API key.