GuidesAPIMCP

Connected accounts

One isolated client workspace under your platform org.

Provision

  1. POST /api/platform/connected-accounts with external_id, name, optional billing_mode and initial_credits.
  2. Same external_id twice returns the existing account (idempotent).

Scope every call

  1. Add header: Atlas-Account: ext_<external_id> (or use connected_org_id UUID).
  2. Without it, envelopes land on your platform org, not the client.

Manage

  1. GET /api/platform/connected-accounts to list.
  2. PATCH .../{id} with { "status": "suspended" } to block sends (403 on send; drafts still work).

Common mistakes

  1. Profile API key + Atlas-Account → use a platform key instead.
  2. Missing header on send → envelope scoped to platform org.
  3. Client expects Atlas login → connected accounts are API-scoped by default.

Related

Billing modes · Platform quickstart