# Create a new organization (platform owner only) (/docs/api-reference/organizations/OrganizationsController_create)

`POST /api/organizations`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

## Request body

Required.

Content type: `application/json`

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name",
      "example": "Acme Factory"
    },
    "slug": {
      "type": "string",
      "description": "URL-friendly slug",
      "example": "acme-factory"
    },
    "tier": {
      "type": "string",
      "description": "Subscription tier",
      "enum": [
        "basic",
        "iot",
        "ai"
      ],
      "default": "basic"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone",
      "example": "Asia/Kuala_Lumpur",
      "default": "Asia/Kuala_Lumpur"
    },
    "locale": {
      "type": "string",
      "description": "Locale",
      "example": "en-MY",
      "default": "en-MY"
    },
    "oeeTarget": {
      "type": "number",
      "description": "OEE target percentage",
      "example": 85
    },
    "address": {
      "type": "string",
      "description": "Physical address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "email": {
      "type": "string",
      "description": "Contact email"
    }
  },
  "required": [
    "name",
    "slug"
  ]
}
```

## Responses

### 201: Organization created

### 409: Slug already taken