---
title: "Create a company"
method: POST
path: "/v1/partner/companies"
tags: ["companies"]
---

# Create a company

`POST /v1/partner/companies`

## Headers

- `Authorization` string, required

## Request body

- object
  - `legal_name` string, required — Legal name of the company
  - `ein` string — Employer Identification Number
  - `external_id` string — External identifier
  - `dba_name` string — Doing business as name
  - `contact_email` string, email
  - `contact_name` string
  - `contact_phone_number` string
  - `entity_type` string
  - `formation_state` string
  - `formation_date` string, date
  - `addresses` TypeCompaniesCreateCompanyRequestAddressesItem[]
    - `address_line1` string
    - `address_line2` string
    - `city` string
    - `state` string
    - `postal_code` string
    - `address_type` string

## Response `201`

company created

- TypeAgentCompany
  - `object` string, required
  - `id` string, uuid, required
  - `legal_name` string, required — Legal name of the company
  - `dba_name` string, nullable — Doing business as name
  - `external_id` string, nullable — External identifier for the company
  - `account_id` string, uuid, required — Account ID the company belongs to
  - `parent_account` TypeAgentCompanyParentAccount
    - `id` string, uuid
    - `name` string
    - `slug` string

## Other responses

- `409` — company already exists

---

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