Skip to main content
POST
/
api
/
vertical
Create a vertical (public, only one allowed)
curl --request POST \
  --url https://your-instance.example.com/api/vertical \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "TetherAI"
}
'
{
  "message": "Vertical created",
  "vertical": {
    "_id": "65b1f0a2c3d4e5f6a7b8c9d0",
    "name": "TetherAI",
    "createdAt": "2026-05-18T12:00:00.000Z",
    "updatedAt": "2026-05-18T12:00:00.000Z"
  }
}

Body

application/json
​
name
string
required

Vertical display name (e.g. Property Management, Auto Sales); used to scope onboarding defaults.

Response

Vertical created successfully

Response from POST /api/vertical.

​
vertical
object
required

The single vertical configured for this deployment. On the fallback path (no record exists yet) only name is populated.

Example:
{
  "_id": "65b1f0a2c3d4e5f6a7b8c9d0",
  "name": "TetherAI",
  "createdAt": "2026-01-12T09:15:00.000Z",
  "updatedAt": "2026-04-04T17:42:00.000Z"
}
​
message
string