---
title: "Create Organization"
method: POST
path: "/v1/admin/organizations"
tags: ["admin", "organizations"]
---

# Create Organization

`POST /v1/admin/organizations`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v1/admin/organizations`
- Auth: HTTP bearer

Create a new organization with a default workspace and assign an initial admin user.
Sends an invitation email to the new admin user as notification.
Only accessible by super admin users.

## Request body

- OrganizationAdminCreateRequest: Request schema for creating a new organization with default workspace and admin user.
  - `name` string, required
  - `email` string, email, nullable
  - `phone` string, nullable
  - `timezone` string, nullable
  - `domain_name` string, nullable
  - `allow_domain_registration` boolean
  - `dot_number` string, nullable
  - `workspace_name` string, nullable
  - `workspace_app_type` 'AP' | 'AP_NEW' | 'CARRIER' | 'OUTREACH'
  - `admin_user` AdminUserInput, required: Admin user details for organization creation.
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required

## Response `200`

Successful Response

- OrganizationDetailAdminSchema: Schema for organization detail with full nested data.
  - `id` string, required
  - `name` string, required
  - `domain_name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `timezone` string, nullable
  - `business_hours` object, nullable
  - `allow_domain_registration` boolean
  - `dot_number` string, nullable
  - `created_at` string, required
  - `updated_at` string, required
  - `users` OrgUserSchema[]
    - `id` string, required
    - `email` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `role` string, nullable
  - `workspaces` OrgWorkspaceSchema[]
    - `id` string, required
    - `name` string, required
    - `app_type` string, required
  - `integrations` OrgIntegrationSchema[]
    - `id` string, required
    - `name` string, nullable
    - `integration_name` string, nullable
    - `created_at` string, required
  - `products` OrgProductSchema[]
    - `id` string, required
    - `feature` string, nullable
    - `enabled` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)