API reference

Create a tenant

Creates a new tenant and assigns the calling user as owner. Used by the onboarding wizard.

POST/v1/admin/tenants

Creates a tenant and gives the authenticated user the owner role on it.

Request

bash

curl -X POST https://api-raven-cloud.autotribes.app/v1/admin/tenants \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Co", "countryCode": "KE", "defaultLocale": "en" }'

Body

Field	Type	Notes
`name`	string · required	2–80 chars. Display name.
`slug`	string · optional	Auto-generated from name if omitted.
`countryCode`	ISO-3166-1 alpha-2 · optional	e.g. `KE`, `NG`
`defaultLocale`	string · optional	Defaults to `en`
`defaultTz`	IANA tz · optional	Defaults to `Africa/Nairobi`

Response

201 Created

json

{
  "id": "8ad4f7c2-9e3b-4a1c-bc2f-1d8e3a9b7c4d",
  "slug": "acme-co",
  "name": "Acme Co",
  "status": "active",
  "plan": "free",
  "countryCode": "KE",
  "defaultLocale": "en",
  "defaultTz": "Africa/Nairobi",
  "createdAt": "2026-05-01T10:23:18.114Z"
}