---
title: "Connected social accounts (identity only, never tokens)."
method: GET
path: "/api/connections"
---

# Connected social accounts (identity only, never tokens).

`GET /api/connections`

## Request

- Base URL: `https://shapelessai.com`
- URL: `https://shapelessai.com/api/connections`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://shapelessai.com/api/auth/mcp/authorize`, token URL `https://shapelessai.com/api/auth/mcp/token`, scopes: `read`)

## Response `200`

OK

- ConnectionList
  - `connections` Connection[]
    - `id` string
    - `platform` string
    - `handle` string
    - `displayName` string, nullable
    - `avatarUrl` string, nullable
    - `status` 'active' | 'expired'
    - `mode` 'oauth' | 'tracked': tracked = handle only, cannot publish.
    - `queue` QueueConfig
      - `slots` string[], required
      - `timezone` string, required: IANA zone the slots are written in.
    - `reconnect` ConnectLinkCreated
      - `platform` string, required
      - `url` string, uri, required: Hand this to the human; opens in a browser.
      - `expiresAt` string, date-time, required
      - `open` string: What to tell the human.
  - `connect` ConnectLinkCreated[]: One link per platform with no live account: hand it to the human, they click, the account appears here.
    - `platform` string, required
    - `url` string, uri, required: Hand this to the human; opens in a browser.
    - `expiresAt` string, date-time, required
    - `open` string: What to tell the human.

## Other responses

- `401`: No credential, or not valid.
- `403`: The key is missing the "read" scope.
- `429`: Over the key's rate limit (600 requests an hour).

---

[API](https://skmtc.dev/shapelessai/apis/shapeless-api.md) · [All operations](https://skmtc.dev/shapelessai/apis/shapeless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shapelessai/apis/shapeless-api/revisions/fae8f701d466?raw)