Skip to main content
POST
/
api
/
v1
/
orgs
Create Organization
curl --request POST \
  --url https://api.example.com/api/v1/orgs \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "slug": "<string>"
}
'
Create an organization for multi-user access, team billing, and connector management.

​
Authentication

Requires a Bearer token. See Authentication.

​
Request Body

​
name
string
required
Organization name.
​
type
string
Organization type. One of: team (default), agency, carrier, fmo, mga, broker.
​
slug
string
Unique URL-friendly identifier. Must be lowercase alphanumeric with hyphens. Generated automatically from name when omitted.

​
Request Example

curl -X POST https://hitheo.ai/api/v1/orgs \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "type": "team",
    "slug": "acme-corp"
  }'

​
Response (HTTP 201)

Returns the created organization object with generated id and timestamps.

​
Endpoint

POST /api/v1/orgs Requires authentication via Bearer token. See Authentication.