GET /v1/projects/:projectId/social-accounts

List every social account attached to the project - OAuth-connected accounts from your end-customers and leased TikTok accounts provisioned by Layers. Both appear in the same list with a leased boolean so you can tell them apart.

Use this endpoint before scheduling a post - its socialAccountId values are what you pass into POST /v1/content/:id/schedule targets.

Example request

curl "https://api.layers.com/v1/projects/prj_254a4ce1-f4ca-42b1-9e36-17ca45ef3d39/social-accounts?platform=tiktok&status=connected" \
  -H "Authorization: Bearer lp_..."

const { items } = await layers.social.listAccounts({
  projectId: "prj_254a4ce1-f4ca-42b1-9e36-17ca45ef3d39",
  platform: "tiktok",
  status: "connected",
});

const publishable = items.filter((a) => a.status === "connected");

accounts = layers.social.list_accounts(
    project_id="prj_254a4ce1-f4ca-42b1-9e36-17ca45ef3d39",
    platform="tiktok",
    status="connected",
)
publishable = [a for a in accounts["items"] if a["status"] == "connected"]

Response

{
  "items": [
    {
      "socialAccountId": "sa_9c1e42a0-b7f3-4e5d-a2c1-8b4f5e6c7d8e",
      "platform": "tiktok",
      "handle": "acmecoffee",
      "avatarUrl": "https://media.meetsift.com/tiktok/acmecoffee/avatar.jpg",
      "status": "connected",
      "leased": false,
      "connectedAt": "2026-04-18T19:06:42Z",
      "tokenExpiresAt": "2026-05-18T19:06:42Z"
    },
    {
      "socialAccountId": "sa_9c1e42a0-b7f3-4e5d-a2c1-8b4f5e6c7d8e",
      "platform": "tiktok",
      "handle": "coffee.reviews.daily",
      "avatarUrl": "https://media.meetsift.com/tiktok/coffee.reviews.daily/avatar.jpg",
      "status": "connected",
      "leased": true,
      "connectedAt": "2026-04-12T08:00:00Z",
      "tokenExpiresAt": null
    }
  ],
  "nextCursor": null
}

Pagination

Results are ordered by connectedAt descending. To fetch the next page, pass the previous response's nextCursor back as the cursor query param:

let cursor: string | null = null;
const all: SocialAccount[] = [];

do {
  const url = new URL(`https://api.layers.com/v1/projects/${projectId}/social-accounts`);
  if (cursor) url.searchParams.set("cursor", cursor);
  const { items, nextCursor } = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.LAYERS_API_KEY!}` },
  }).then(r => r.json());
  all.push(...items);
  cursor = nextCursor;
} while (cursor);

nextCursor is null when there's nothing more to fetch. Don't compute or modify the cursor — it's an opaque server-issued value (currently the connectedAt of the last item on the page, but treat it as opaque so it can evolve).

Status values

Errors

See also

• POST /v1/projects/:projectId/social/reauth-url - fix a reauth_required account
• DELETE /v1/social-accounts/:socialAccountId - disconnect an account
• GET /v1/leased-accounts - leased accounts with billing detail