---
title: "Create a company"
method: POST
path: "/api/v2/companies"
tags: ["Companies"]
---

# Create a company

`POST /api/v2/companies`

Create a new company.

## Headers

- `X-Organization-Id` string, required

## Response `201`

Single company

## Other responses

- `422` — Unprocessable Entity

## Changes

- **2026-09-02** `061c271b2e3a` — 4 info
  - added the new optional request property `data/attributes/domains`
  - request property `data/attributes/domain` deprecated
  - added the optional property `data/attributes/domains` to the response with the `201` status
  - response property `data/attributes/domain` deprecated

[Change history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/companies/post.md)

---

[API](https://skmtc.dev/productive/apis/api-documentation.md) · [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/061c271b2e3a/schema)