Skip to main content
POST
Create an organization for the signed-in user

Authorizations

Authorization
string
header
required

WorkOS access JWT or a user-owned WorkOS API key. User keys are bound to one organization and restricted to their enabled product permissions. Session-only onboarding and session revocation require an interactive access JWT. No cookie session is assumed.

Headers

X-Request-Id
string

Optional caller-provided correlation identifier.

Required string length: 1 - 128
Idempotency-Key
string
required

Stable creator-scoped key; repeat unchanged to observe an incomplete creation.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Body

application/json
signup_source
string
required

Public acquisition source from the invitation URL's r parameter. Eligibility and promotional credits are server-configured; attribution is fixed for the user and rewards are never multiplied by retries or additional organizations.

Required string length: 1 - 64
Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
name
string
required
Required string length: 1 - 128
Pattern: ^\S(?:.*\S)?$

Response

Organization and Owner membership are persisted. Idempotent replay returns the same identity.

id
string
required
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
name
string
required
Required string length: 1 - 128