List connected social accounts
social_accounts_listUse this when the user asks which of their own social media accounts are in their Sociality.io workspace, or before calling social_account_stats_list or social_account_posts_list, which need an account ID from this list. Returns each account's ID, name, username, channel and whether its connection is active (is_token_active). Filter by channel or by name. Do not use it for competitors or other public accounts the user does not manage: social_competitors_list covers those.Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "social_accounts_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only return accounts whose name or username contains this text, for example "pepsi". | |
| page | No | Page number, starting at 1. Each page has up to 50 accounts; check pagination.has_more for more. | |
| channel | No | Only return accounts on this channel: facebook, instagram, x, linkedin, tiktok or youtube. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| accounts | Yes | List of social media accounts the user has access to. | |
| _envelope | Yes | Versioned response envelope metadata. | |
| pagination | Yes | ||
| action_required | No | Present only when a user action is required before this request can be answered. The data block is empty and no credits were charged. Do not re-call this tool with different arguments or a wider date range; the workspace needs a change first, unless the action says how to adjust the call or names a tool that makes the change. |