Sub-Accounts

Business-plan accounts can create sub-accounts — separate workspaces (own templates, brand kit, and members) that inherit the parent's plan and share its pooled usage limits. Typical use: agencies managing one workspace per client.

Create a sub-account

curl -b cookies.txt -X POST \
  https://app.templated.email/api/accounts/{slug}/sub-accounts \
  -H "Content-Type: application/json" \
  -d '{ "name": "Client — Acme Co" }'

{
  "data": {
    "id": "e5f6a7b8-...",
    "name": "Client — Acme Co",
    "slug": "client-acme-co",
    "plan": "business",
    "parentAccountId": "a1b2c3d4-...",
    "createdAt": "2026-07-21T10:00:00.000Z"
  }
}

Returns 201. The requesting user becomes the sub-account's owner, and the sub-account inherits the parent's plan. Requires the subaccount:create permission on the parent. Returns 400 with code: SUB_ACCOUNT_LIMIT when the parent can't have (more) sub-accounts.

List sub-accounts

curl -b cookies.txt \
  https://app.templated.email/api/accounts/{slug}/sub-accounts

{
  "data": [
    {
      "id": "e5f6a7b8-...",
      "name": "Client — Acme Co",
      "slug": "client-acme-co",
      "plan": "business",
      "createdAt": "2026-07-21T10:00:00.000Z",
      "templateCount": 12,
      "memberCount": 3
    }
  ]
}

Detach a sub-account

curl -b cookies.txt -X DELETE \
  https://app.templated.email/api/accounts/{slug}/sub-accounts/{subSlug}

This detaches rather than deletes: the sub-account becomes a standalone account on the Free plan, keeping its templates and members. Requires the subaccount:manage permission on the parent.

Working with a sub-account

A sub-account is a regular account — use its slug with any other endpoint (/api/accounts/{subSlug}/templates, etc.). Usage-metered features (AI generations, design imports) draw from the parent's pooled allowance.