---
title: "Create an organization"
method: POST
path: "/v1/organizations"
tags: ["Organizations"]
---

# Create an organization

`POST /v1/organizations`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/organizations`
- Auth: API key in header `x-api-key`

Creates a new organization under the current billing account and returns it.

## Request body

- object
  - `name` string, required

## Response `200`

Organization

- Organization
  - `id` string, required
  - `billingAccountId` string, required
  - `name` string, required
  - `slug` string, required
  - `defaultRegion` string, required: An ISO 3166-1 alpha-2 region code, such as US or IN.
  - `timezone` string, required
  - `plan` string, required
  - `isActive` boolean, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `metadata` object, nullable, required
  - `replyToDefault` string[], nullable, required
  - `emailFooterEnabledDefault` boolean, nullable, required
  - `messagesUsed` number, required
  - `messagesUsedThisMonth` number, required
  - `emailUsed` number, required
  - `emailUsedThisMonth` number, required
  - `contactsUsed` number, required
  - `conversationsUsed` number, required
  - `teamMembersUsed` number, required
  - `messagesResetAt` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `402`: PaymentRequiredError
- `403`: ForbiddenError
- `422`: ValidationError
- `500`: InternalError
- `502`: BillingProviderError
- `504`: GatewayTimeoutError

---

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