> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt

Configured tool · write

# `list_accounts`

List destination account IDs and connection state, synchronizing provider state into Postdom for this workspace.

write · non-destructive · closed-world

Human and agent roles

## Configured boundary

### Configured workspace

The workspace agent key scopes this read to one organization. The tool cannot discover or read accounts belonging to another workspace.

This reference describes the hosted server at https://api.postdom.com/mcp, which runs current source, with a workspace-scoped key created under Connected apps → For developers. The published `@postdom/mcp@0.4.0` package has 14 of these tools: it lacks list_posts, create_slideshow, account_music and the media array.

Callable schema

## Input fields

Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.

 Field  Type  Contract

**For AI agents:** Send only fields exposed by the current tool schema.

**Known failure:** Do not invent platform settings, account IDs, media fields, or setup steps.

Synthetic values

## Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

_EXAMPLE CALL · CONFIGURED TOOL SCHEMA_

```
list_accounts({})
```

Observed API record

## Return shape

Returns the provider-backed accounts visible to the configured workspace.

**`accounts[].providerAccountId` (string)** — The exact destination ID accepted by account_ids in planning and publishing tools.

**`accounts[].platform` (instagram | tiktok | youtube | linkedin | facebook | snapchat | twitter | threads | bluesky)** — The account's destination platform.

**`accounts[].handle` (string | null)** — Provider handle when available.

**`accounts[].status` (connected | expired | disconnected)** — Current provider connection state.

**`accounts[].trust_level` (integer)** — Current human-selected autonomy level.

**`accounts[].paused` (boolean)** — Whether execution is paused for this account.

**`accounts[].timezone` (IANA timezone)** — Account timezone used to evaluate policy quiet hours; UTC is the fallback.

**`accounts[].autonomy_prompt_eligible` (boolean)** — Whether the dashboard still offers its one-time autonomy-default decision for this account.

Stop conditions

## Agent handoff

`connected`

### Use the exact ID

Pass providerAccountId to later tools; never substitute a handle or invent an ID.

`empty`

### Inspect the gate

Call get_workspace_status before attempting connect_account.

`expired or disconnected`

### Return to the human

The human must complete provider authorization; this tool neither requests nor carries social credentials.

 VERIFIED · 26 AUGUST 2026  **GET /v1/accounts · list_accounts MCP registration**

Examples are synthetic. Human workspace-key creation and revocation remain in Postdom under Connected apps → For developers.