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

Configured tool · write

# `connect_account`

Create a platform authorization URL for a human to complete when the workspace connection gate is unlocked.

write · non-destructive · open-world

Human and agent roles

## Configured boundary

### Configured workspace

This tool initiates a handoff only. It cannot authorize a social account, enter credentials, unlock the workspace gate, or connect another organization's profile.

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 |
| --- | --- | --- |
| platform Required | enum | the eight destinations that authorize by redirect The destination platform the human intends to authorize. Bluesky is deliberately absent: it authorizes with an app password rather than a redirect, so there is no URL for this tool to return and a human connects it in the dashboard instead. |

**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_

```
connect_account({
  platform: "instagram"
})
```

Configured behavior

## When you connect

The same claims the dashboard Connect chooser summarizes. They are derived from the connect mechanism map, not written a second time here.

 WILL

### Will

Publish the video you supply, under the policy you set.

 WILL NOT

### Will not

Store a platform password for OAuth — you sign in on the destination. Bluesky uses an app password once to connect and does not keep it.

 YOU CAN

### You can

Revoke the connection anytime.

Observed API record

## Return shape

Returns a provider authorization URL whose completion belongs to the human.

**`connect_url` (URL)** — Open this URL for the human; never request or enter their social credentials.

Stop conditions

## Agent handoff

`connect_url returned`

### Give the URL to the human

Wait for the human to finish authorization, then poll list_accounts for the connected destination.

`connect_disabled`

### Stop and report the gate

Do not attempt to unlock the workspace or route around the human-controlled gate.

`supplier_spend_guard or account_cap_reached`

### Ask the human

Postdom intentionally stopped before adding supplier cost or exceeding the account cap.

 VERIFIED · 26 AUGUST 2026  **POST /v1/accounts/connect · connect_account MCP registration**

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