list_accounts

List active connected social media accounts. Returns account IDs needed for the accountId parameter in publish_post. Only shows accounts with status "active" (connected and authorized).

Parameters

When to use

Discover which social accounts are connected to a workspace. Every publish_post call needs an accountId — this is where you get it.

Typical flow: agent starts a conversation with an end user, calls list_accounts to populate a picker or to disambiguate "post to my Twitter" when the user has multiple Twitter accounts connected.

Example

{ "workspaceId": "wks_01H..." }

Response:

{
  "accounts": [
    {
      "id": "acc_01H...",
      "platform": "twitter",
      "username": "@postato_br",
      "displayName": "Postato",
      "status": "connected"
    },
    {
      "id": "acc_01H...",
      "platform": "instagram",
      "username": "postato.br",
      "status": "connected"
    }
  ]
}

Status values

• connected — OAuth token is valid; publishing works.
• token_expired — refresh failed or the user revoked access on the platform side. Publishing will fail until the user reconnects.
• suspended — the platform has suspended the account; Postato cannot push content.

Agents should surface non-connected states clearly: asking the user to reconnect on the Postato dashboard.

Gotchas

• Accounts are workspace-scoped. The same person may have Twitter connected across multiple workspaces — each is an independent record with its own accountId.
• Username is informational; never match by username alone. Always use accountId when calling publish_post.
• Freshly connected accounts may take a few seconds to appear. If a user just completed OAuth and the account isn't in the list, retry after 5 seconds.