List connected platforms

List the social accounts connected to a workspace.

Last checked against the API October 10, 2026 · View as Markdown

GEThttps://studio.postprism.app/api/v1/platforms

Returns the social accounts connected in the workspace. Use each platform value as a key in platforms and platform_content when you create a post.

Accounts are connected in Postprism, through each network’s own sign-in; the API cannot connect new accounts.

Parameters

NameInTypeDescription
workspace_idqueryuuidAct on another workspace you belong to. Defaults to the workspace your API key was created in.

Example

List connected accounts
curl "https://studio.postprism.app/api/v1/platforms" \
  -H "Authorization: Bearer pp_live_your_api_key"

Response

200. data is an array of PlatformConnection. A social account connected to the workspace.

iduuid

The connection ID.

platformstring

The platform key to use in platforms and platform_content. A LinkedIn Company Page appears as linkedin:org:<page id>, next to the personal linkedin profile.

platform_usernamestringnullable

The account name on the platform.

is_connectedboolean

Always true: only live connections are listed.

created_atdate-time

When the account was connected.

updated_atdate-time

When the connection last changed.

200 response
{
  "data": [
    {
      "id": "1e2f3a4b-0000-4000-8000-00000000d001",
      "platform": "twitter",
      "platform_username": "juniperroasters",
      "is_connected": true,
      "created_at": "2026-09-02T10:15:00Z",
      "updated_at": "2026-09-02T10:15:00Z"
    },
    {
      "id": "1e2f3a4b-0000-4000-8000-00000000d002",
      "platform": "linkedin",
      "platform_username": "Maya Lindqvist",
      "is_connected": true,
      "created_at": "2026-09-02T10:18:00Z",
      "updated_at": "2026-09-02T10:18:00Z"
    }
  ],
  "error": null
}

Errors

StatusMessageWhen
401Invalid or revoked API keyThe Authorization header is missing, malformed, or the key was revoked.
404Workspace not found, or you are not a member of it.The workspace_id you passed (or your key’s default workspace) is not one you belong to.
429Too many requestsYou went over the hourly limit. See Rate limits.
PreviousGet analyticsNextGet your workspace