Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

A logged-in user session bearer token (WorkOS AuthKit access token from signup/login).

Body

application/json
name
string
required

Display name for the organization.

description
string
website_url
string

Response

Organization created. A fresh org always starts on the free tier with a rate_limit_rpm of 100, and its slug is derived from the name with a short random suffix appended for uniqueness. logo_url is empty until you set one, and created_at equals updated_at. (Body captured verbatim from the live sandbox.)

id
string<uuid>

Unique identifier for this resource.

name
string

Human-readable display name.

slug
string

URL-safe stable identifier.

description
string

Human-readable description.

website_url
string

URL for website.

logo_url
string

URL for logo.

owner_user_id
string<uuid>

UUID identifier.

tier
string

Accreditation / integration tier of the organization. New orgs start on free; higher tiers (e.g. accredited) are granted after the OCSS accreditation review.

Example:

"free"

rate_limit_rpm
integer

Per-minute request-rate limit applied to this organization's keys.

created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.

updated_at
string<date-time>

RFC 3339 timestamp of the resource's most recent update.