Create a new organization

POST /api/v1/organizations

Creates an organization owned by the caller (who becomes its admin). The name is required, cannot be "Personal", and cannot duplicate the name of an organization the caller already belongs to.

Request body (application/json)

Field	Type	Required	Description
name	string	yes	Organization name; required, not "Personal", unique among the caller's organizations

Example request

curl https://api.mobilenexthq.com/api/v1/organizations \
  -X POST \
  -H 'Authorization: Bearer mob_...' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string"}'

Responses

201 — Organization created

{
  "organizationId": 0,
  "organizationName": "string",
  "organizationType": "starter",
  "role": "admin",
  "createdAt": "2026-01-01T00:00:00Z"
}

400 — Invalid request body

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

401 — Missing or invalid Bearer token

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

409 — Request conflicts with current state (e.g. already a member or already invited)

{
  "error": {
    "code": "string",
    "message": "string"
  }
}