# List connected platforms

> List the social accounts connected to a workspace.

**Source:** https://postprism.app/docs/api/list-platforms  
**Updated:** 2026-10-10

---

`GET https://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

| Name | In | Type | Description |
| --- | --- | --- | --- |
| `workspace_id` | query | uuid | Act on another workspace you belong to. Defaults to the workspace your API key was created in. |

## Example

```bash
curl "https://studio.postprism.app/api/v1/platforms" \
  -H "Authorization: Bearer pp_live_your_api_key"
```

## Response

Status `200`.

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

| Field | Type | Description |
| --- | --- | --- |
| `id` | uuid | The connection ID. |
| `platform` | string | 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_username` | string, nullable | The account name on the platform. |
| `is_connected` | boolean | Always `true`: only live connections are listed. |
| `created_at` | date-time | When the account was connected. |
| `updated_at` | date-time | When the connection last changed. |

```json
{
  "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

| Status | Message | When |
| --- | --- | --- |
| 401 | `Invalid or revoked API key` | The `Authorization` header is missing, malformed, or the key was revoked. |
| 404 | `Workspace 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. |
| 429 | `Too many requests` | You went over the hourly limit. See Rate limits. |