Skip to main content
POST
Provision an organization (service key)

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Body

application/json
name
string
required

Organization display name.

Required string length: 1 - 255
ownerEmail
string<email>
required

Email of the org owner; the user is found-or-created.

Maximum string length: 255
timezone
string

IANA timezone (e.g. America/New_York). Defaults to UTC.

defaultLocale
enum<string>

Default locale for the org. Defaults to en-us.

Available options:
en-us,
es,
pt

Response

Existing organization returned (idempotent repeat).

id
string<uuid>
required
slug
string
required

URL slug, <name>-<8 hex>.

orgUrl
string<uri>
required

Absolute URL to the org dashboard.

ownerUserId
string<uuid>
required
created
object
required

Whether each entity was newly created (vs. reused).