Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Site Media
Publish Site
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
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
Site Media
Publish Site
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
Sponsored
Aveiro
aveiro.app
Sponsored
Aveiro
aveiro.app
TrademarkTrademark
AveiroBlogContact
© Aveiro. All rights reserved.
Built with Aveiro

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 1mo 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" }
  ]
}