> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dohoo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections API: List Your Social Account Connections

> Use the Dohoo Connections API to list all connected social accounts and retrieve the connection IDs required by every publishing endpoint.

The Connections API returns a list of every social account you have connected to your Dohoo account. Each connection record includes a unique `id`, the platform it belongs to, and the account's display name. You need the `connectionId` from this response when calling any of Dohoo's publishing endpoints — it tells Dohoo exactly which account to post to.

<Note>
  All Connections API requests require your API key in the `X-API-Key` header.

  ```
  X-API-Key: dh_live_xxxxxxxxxxxxxxxxxxxxxxxx
  ```
</Note>

***

## Get all connections

<br />

`GET /api/connections/unified`

Returns a unified list of all social accounts connected to your Dohoo account, regardless of platform. Use the `id` field from any entry as the `connectionId` parameter in publishing requests.

```bash theme={null}
curl https://dohoo.ai/api/connections/unified \
  -H "X-API-Key: dh_live_xxxx"
```

**Response**

```json theme={null}
[
  { "id": "conn_instagram_001", "platform": "instagram", "name": "@myhandle" },
  { "id": "conn_youtube_001", "platform": "youtube", "name": "My Channel" },
  { "id": "conn_tiktok_001", "platform": "tiktok", "name": "@myaccount" }
]
```

**Response fields**

<ParamField body="id" type="string">
  The unique connection identifier. Pass this value as `connectionId` when publishing content to this account.
</ParamField>

<ParamField body="platform" type="string">
  The social media platform this connection belongs to (e.g. `instagram`, `youtube`, `tiktok`).
</ParamField>

<ParamField body="name" type="string">
  The human-readable display name or handle of the connected account.
</ParamField>

<Tip>
  Cache the connection list in your automation workflow and refresh it only when you add or remove accounts. Calling this endpoint on every publish request adds unnecessary latency and consumes API quota.
</Tip>

<Info>
  You can only add or remove social account connections from the **Dohoo dashboard → Connections**. The API does not provide endpoints for creating or revoking connections.
</Info>