Create organization

POST/v1/organizations

Onboards the authenticated user’s partner Organization: creates the local Organization + the creator’s admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). 409 organization_already_exists when the user already has an organization (v0: one organization per user).

Body ParametersJSONExpand Collapse

name: string

maxLength255

minLength1

type: optional "BROKERAGE" or "TPA" or "GENERAL_AGENT" or 3 more

BROKERAGE - BROKERAGE
TPA - TPA
GENERAL_AGENT - GENERAL_AGENT
CHANNEL_PARTNER - CHANNEL_PARTNER
CONSULTING_FIRM - CONSULTING_FIRM
API_PLATFORM - API_PLATFORM

One of the following:

"BROKERAGE"

"TPA"

"GENERAL_AGENT"

"CHANNEL_PARTNER"

"CONSULTING_FIRM"

"API_PLATFORM"

ReturnsExpand Collapse

id: string

Prefixed organization identifier (org_<base64-encoded-uuid>).

idp_org_id: string

IdP-issued tenant id (WorkOS org id).

idp_provider: "workos" or "vitable"

workos - WorkOS
vitable - Vitable

One of the following:

"workos"

"vitable"

name: string

Human-readable organization name.

super_in: boolean

Whether this organization reads across every organization.

type: "BROKERAGE" or "TPA" or "GENERAL_AGENT" or 3 more

BROKERAGE - Brokerage
TPA - TPA
GENERAL_AGENT - General Agent
CHANNEL_PARTNER - Channel Partner
CONSULTING_FIRM - Consulting Firm
API_PLATFORM - API Platform

One of the following:

"BROKERAGE"

"TPA"

"GENERAL_AGENT"

"CHANNEL_PARTNER"

"CONSULTING_FIRM"

"API_PLATFORM"

Create organization

curl https://api.vitablehealth.com/v1/organizations \
    -H 'Content-Type: application/json' \
    -d '{
          "name": "Acme Brokerage"
        }'

{
  "id": "org_abc123def456",
  "name": "Acme Brokerage",
  "type": "BROKERAGE",
  "idp_org_id": "org_01J0WORKOS",
  "idp_provider": "workos",
  "super_in": false
}

Returns Examples

{
  "id": "org_abc123def456",
  "name": "Acme Brokerage",
  "type": "BROKERAGE",
  "idp_org_id": "org_01J0WORKOS",
  "idp_provider": "workos",
  "super_in": false
}