Skip to main content
POST
Create organization during OAuth onboarding

Authorizations

Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Body

application/json
session
string
required

Session UUID from OAuth callback

csrf_token
string
required

CSRF token for validation

name
string
required

Organization name

Required string length: 1 - 100

Response

OK

user
object
required
domains
string[]
required

List of authorized domains

csrfToken
string
required

CSRF token for consent form submission

needsOrgCreation
boolean
required

Whether user needs to create an organization before continuing

suggestedOrgName
string | null
required

Suggested organization name from email domain

warning
string

Warning message (e.g., org context failed to load)