---
title: "Create organization"
method: POST
path: "/org"
tags: ["Organizations"]
---

# Create organization

`POST /org`

This endpoint lets you create an organization. You have `WRITE` access on your provider (ie. only possible if you have `PROVIDER` role).

## Request body

- object — JSON to create an organization
  - `name` string, required — Organization name
  - `alias` string — Organization alias (should match regex `[a-z0-9_]`)
  - `max_businesses` integer, nullable — Maximum number of local businesses the organization can have. It does not include the global (brand) businesses. If null, there is no limit for the organization. This field can only be set by a `PROVIDER` user.

## Response `200`

OK

- object — Result object
  - `status` 'success' — Request status
  - `org_id` integer — Unique identifier of an organization in Partoo.
  - `alias` string — Organization alias (should match regex `[a-z0-9_]`)
  - `max_businesses` integer, nullable — Maximum number of local businesses the organization can have. It does not include the global (brand) businesses. If null, there is no limit for the organization. This field can only be set by a `PROVIDER` user.

## Other responses

- `400` — Your request is incorrect
- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)