---
title: "Connection status"
method: GET
path: "/v1/connections/{connectionId}"
tags: ["Connections and Accounts"]
---

# Connection status

`GET /v1/connections/{connectionId}`

## Request

- Base URL: `https://getsocialclaw.com`
- URL: `https://getsocialclaw.com/v1/connections/{connectionId}`
- Auth: HTTP bearer

Returns the status of one connection handshake.

## Path parameters

- `connectionId` string, required

## Response `200`

Successful response.

- ConnectionResponse: Connection response.
  - `ok` unknown, required
  - `connection` Connection: Connection handshake status.
    - `id` string, required: Connection id.
    - `provider` 'x' | 'threads' | 'meta' | 'facebook' | 'instagram_business' | 'instagram' | 'snapchat' | 'tiktok' | 'linkedin' | 'linkedin_page' | 'pinterest' | 'youtube' | 'reddit' | 'discord' | 'telegram' | 'wordpress', required: Provider being connected.
    - `status` string, nullable: pending, connected, failed, or provider-specific state.
    - `authorizeUrl` string, nullable: OAuth authorize URL when OAuth is required.
    - `account` ConnectedAccount: Social account or destination connected to a SocialClaw workspace.
      - `id` string, required: Connected account id.
      - `provider` 'x' | 'threads' | 'meta' | 'facebook' | 'instagram_business' | 'instagram' | 'snapchat' | 'tiktok' | 'linkedin' | 'linkedin_page' | 'pinterest' | 'youtube' | 'reddit' | 'discord' | 'telegram' | 'wordpress', required: Canonical provider id.
      - `handle` string, required: Stable account handle used in schedules.
      - `displayName` string, nullable: Display name.
      - `accountType` string, nullable: Provider-specific account type.
      - `externalId` string, nullable: Provider account id.
      - `status` string, nullable: Connection status.
      - `createdAt` string, date-time, nullable: Creation time.
      - `updatedAt` string, date-time, nullable: Last update time.
    - `error` string, nullable: Connection error message, when failed.
    - `createdAt` string, date-time, nullable: Creation time.
  - `account` ConnectedAccount: Social account or destination connected to a SocialClaw workspace.
    - `id` string, required: Connected account id.
    - `provider` 'x' | 'threads' | 'meta' | 'facebook' | 'instagram_business' | 'instagram' | 'snapchat' | 'tiktok' | 'linkedin' | 'linkedin_page' | 'pinterest' | 'youtube' | 'reddit' | 'discord' | 'telegram' | 'wordpress', required: Canonical provider id.
    - `handle` string, required: Stable account handle used in schedules.
    - `displayName` string, nullable: Display name.
    - `accountType` string, nullable: Provider-specific account type.
    - `externalId` string, nullable: Provider account id.
    - `status` string, nullable: Connection status.
    - `createdAt` string, date-time, nullable: Creation time.
    - `updatedAt` string, date-time, nullable: Last update time.

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, or unauthorized credentials.
- `404`: Requested resource was not found.
- `422`: Request body or semantic validation failed.

---

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