Skip to main content
POST
Create an organization

Authorizations

Authorization
string
header
required

Bearer authentication using a factapi-issued API key (ffy_<env>_<base32_uuid><base62_random>). Cookie-based sessions are accepted automatically by user-facing endpoints but are not surfaced as an OpenAPI auth scheme.

Body

application/json

Fields required to create a new organization.

name
string
required

Human-readable organization name.

Minimum string length: 1
Example:

"Factify"

Response

The newly created organization.

A Factify organization — the tenancy boundary for records, members, and API keys.

id
string
required

Unique organization TypedID. Pattern: org_[0-9a-hjkmnp-tv-z]{26}

Example:

"org_01h2xcejqtf2nbrexx3vqjhp41"

name
string
required

Human-readable organization name.

Example:

"Factify"

created_at
string<date-time>
required

Timestamp when the organization was created.

Example:

"2025-01-15T10:30:00Z"