API ReferenceOrganizations

Create an organization

Authentication

AuthorizationBearer

Admin JWT token via Authorization: Bearer <token>.

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Request

This endpoint expects an object.
namestringRequired
Organization display name.
slugstringRequiredformat: "^[a-z0-9-]+$"

URL-safe identifier.

verification_modeenumOptionalDefaults to auto

Whether sessions are auto-approved or require manual review.

Allowed values:
webhook_urlstringOptionalformat: "uri"
URL to receive webhook events.
webhook_secretstringOptional
Secret used to sign webhook payloads.
minimum_ageintegerOptional>=0
Minimum age requirement for age verification checks.

Response

Organization created.
idstring
namestring
slugstring
is_activeboolean
planenum
Allowed values:
created_atdatetime
verification_modeenum
Allowed values:
webhook_urlstring or null
minimum_ageinteger or null
data_retention_daysinteger or null

Errors

400
Bad Request Error
401
Unauthorized Error