Social Accounts

GET /api/v1/social/accounts — list connected Instagram, Threads, LinkedIn, and X accounts for draft targets. X connect requires a paid plan.

Updated 3 months ago

In short

Returns connected social accounts for the token's organization via Chirio. Use the account ids in targets when creating or updating post drafts. Connect X in the dashboard requires a paid plan.

Request

GET /api/v1/social/accounts
Authorization: Bearer av_live_…

Required scope: social:write

Response

{
  "configured": true,
  "accounts": [
    {
      "id": "acct-uuid",
      "platform": "linkedin",
      "username": "your-company",
      "status": "active"
    }
  ]
}

When Chirio is not configured on the deployment, configured is false and accounts is an empty array.

Using account IDs

Pass account IDs in targets when creating or updating posts:

{
  "targets": [
    { "platform": "instagram", "accountId": "acct-uuid" },
    { "platform": "threads", "accountId": "acct-uuid-2" },
    { "platform": "linkedin", "accountId": "acct-uuid-3" }
  ]
}

Connect accounts in Dashboard → Social before agents can target them. X requires Starter or above — free orgs cannot connect or target it. Platform guide: Connecting accounts.

Errors

HTTP	Code	When
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Token lacks social:write
502	UPSTREAM_ERROR	Chirio request failed

Social API Overview

Social Media

Built with Aveiro

Social Accounts

Social Accounts

Request

Response

Using account IDs

Errors

Related

Request

Response

Using account IDs

Errors

Related