# Accounts

> List connected accounts, refresh their tokens, and disconnect them.

Canonical: <https://www.tryadeli.com/docs/api/accounts>

An account is one provider connection inside a profile. Its `accountId` is the
identifier every other endpoint takes.

## The account object

[List accounts](https://www.tryadeli.com/docs/api/accounts/list-accounts) returns these records, and
[Get account](https://www.tryadeli.com/docs/api/accounts/get-account) returns one bare.

**Account fields**

| Name                | Type                                    | Required | Description                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------- | --------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `accountId`         | `uuid`                                  |          | Use this everywhere. `id` is the same value, kept for clients that expect it.                                                                                                                                                                                                                                                                                                        |
| `providerId`        | `string`                                |          | Instagram's user id, or TikTok's app-scoped open\_id. Informational — do not send it back as an accountId. A TikTok account's open\_id changed once, when it reconnected through TikTok API for Business. For YouTube, the channel id (UC…). For X, the user id, which survives a change of username. For Bluesky, the account's DID (did:plc:…), which survives a change of handle. |
| `displayName`       | `string`                                |          | For Instagram, "@" plus the username. For TikTok, the profile display name. For YouTube, the channel title. For X, the account name. For Bluesky, the display name, or the handle when there is none.                                                                                                                                                                                |
| `displayIdentifier` | `string`                                |          | The Instagram username, or the TikTok username (its open\_id for a connection that has not reconnected since the move to TikTok API for Business), or the YouTube channel handle, such as @adeli (its channel id when it has none), or the X username, or the Bluesky handle.                                                                                                        |
| `authMethod`        | `"instagram_login" \| "facebook_login"` |          | Instagram only: the login the account was connected with. Reconnecting uses the same one; see [Instagram login methods](https://www.tryadeli.com/docs/api/connect#instagram-login-methods).                                                                                                                                                                                          |
| `connectionStatus`  | `string`                                |          | `connected`; `expired` when an Instagram connection has lapsed or, for Facebook Login, its Page can no longer be reached; `reconnect_required` when TikTok, Facebook, YouTube, X, or Bluesky needs fresh consent; `pending_page_selection` when a Facebook connection exists but no Page has been chosen.                                                                            |

## Endpoints

- `GET /api/v1/accounts` — [List accounts](https://www.tryadeli.com/docs/api/accounts/list-accounts.md)
- `GET /api/v1/profiles/{profileId}/accounts` — [List profile accounts](https://www.tryadeli.com/docs/api/accounts/list-profile-accounts.md)
- `GET /api/v1/profiles/{profileId}/accounts/{accountId}` — [Get account](https://www.tryadeli.com/docs/api/accounts/get-account.md)
- `PATCH /api/v1/profiles/{profileId}/accounts/{accountId}` — [Update X account](https://www.tryadeli.com/docs/api/accounts/update-x-account.md)
- `POST /api/v1/profiles/{profileId}/accounts/refresh` — [Refresh tokens](https://www.tryadeli.com/docs/api/accounts/refresh-tokens.md)
- `DELETE /api/v1/profiles/{profileId}/accounts/{accountId}` — [Disconnect account](https://www.tryadeli.com/docs/api/accounts/disconnect-account.md)