digital-identity-platform-docs

---

digital-identity-platform-docs / supabase/functions/create-sub-account

supabase/functions/create-sub-account

Fileoverview

Create Sub-Account Edge Function

Creates a new client (sub-account) under an agency and sends an onboarding invitation. Only users who are admin/owner of an agency (is_agency = true) can create sub-accounts.

Cloudflare Architecture Context

Attribute	Value
Classification	🔵 BACKEND-ONLY
Position	App Backend (agency management)
Receives Public Traffic	No (authenticated agency admins only)
Latency Sensitive	No
Safe to Retry	No (creates resources)
Failure Behavior	Rollback on invitation failure

Endpoint

POST /create-sub-account

Auth

Required - JWT verified, must be agency admin/owner

Example

{
  "clientName": "Acme Corp",
  "email": "client@acme.com",
  "sendInvitation": true
}