Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
TrademarkTrademark
Ctrl k
Search...
Sign up
Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
TrademarkTrademark
AveiroBlogContact
© Aveiro. All rights reserved.
Built with Aveiro
Social

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 3d ago
Social API Overview
Social Media
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: 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
401UNAUTHORIZEDMissing or invalid token
403FORBIDDENToken lacks social:write
502UPSTREAM_ERRORChirio request failed

Related

  • Social API overview
  • Social posts
{
  "targets": [
    { "platform": "instagram", "accountId": "acct-uuid" },
    { "platform": "threads", "accountId": "acct-uuid-2" },
    { "platform": "linkedin", "accountId": "acct-uuid-3" }
  ]
}