Create organization
POST
/organizations
Multi-tier onboarding payload. All validation lives in the service; the controller maps domain errors to status codes. Requires a verified email.
Authorizations
BearerAuth
Authentication is handled automatically via httpOnly session cookies after signing in at /cognito/signin or via Google SSO at /cognito/oauth/google. For Swagger UI testing, paste a JWT token from the /cognito/signin response.
Type
HTTP (bearer)
Request Body
application/json
JSON
{
"legal_name": "string",
"ein": "string",
"country": "string",
"website": "string",
"description": "string",
"categories": [
"string"
],
"kind": "string",
"parent_organization_id": "string",
"dbas": [
{
"dba_name": "string"
}
],
"locations": [
{
"label": "string",
"address": "string"
}
]
}
Responses
Organization created
application/json
JSON
{
"data": {
}
}