---
title: "List connected social accounts"
method: GET
path: "/v1/social-accounts"
tags: ["Videos"]
---

# List connected social accounts

`GET /v1/social-accounts`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/social-accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/social-accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the social accounts you have connected in Tella that POST /v1/videos/{id}/publish can post with: each one's `id` (pass it as `accountId`), its name, and the destinations it posts to. Accounts are connected in Tella (Settings → Connections); this API can't connect one.

## Response `200`

OK

- ListSocialAccountsResponse
  - `accounts` SocialAccount[], required: Oldest first per platform
    - `connected` boolean, required: False when the account needs reconnecting in Tella (Settings → Connections) before it can publish
    - `destinations` string[], required: Where this account can publish
    - `id` string, required: Pass as `accountId` to POST /v1/videos/{id}/publish
    - `name` string, nullable, required: The account's name in Tella: the one the user gave it, else its name on the platform

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 66 revisions in range; 1 not diffed.

- **2026-11-07** `0cc3fcd307ad`: 1 warning
  - added the new `facebook_reel` enum value to the `accounts/items/destinations/items/` response property for the response status `200`
- **2026-10-31** `b616141ddad3`: 5 warning
  - added the new `facebook_post` enum value to the `accounts/items/destinations/items/` response property for the response status `200`
  - added the new `facebook_story` enum value to the `accounts/items/destinations/items/` response property for the response status `200`
  - added the new `instagram_post` enum value to the `accounts/items/destinations/items/` response property for the response status `200`
  - added the new `instagram_reel` enum value to the `accounts/items/destinations/items/` response property for the response status `200`
  - …1 more
- **2026-10-09** `9773130bbc2b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/social-accounts/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/a15e5c06bd15?raw)