---
title: "Create Company"
method: POST
path: "/v1/companies"
tags: ["companies"]
---

# Create Company

`POST /v1/companies`

Create a new Company.  Provide `parent_company_sid` to create a Sub-Company.  The number of Sub-Companies allowed is limited to 10 initially, but you can request to have this limit increased.  Sub-Companies cannot themselves have Sub-Companies.

## Request body

- StreemApiCreateCompanyRequest
  - `code` string
  - `name` string
  - `parent_company_sid` string
  - `owner_email` string
  - `owner_name` string

## Response `201`

The Company or Sub-Company was successfully created

- StreemApiCreateCompanyResponse
  - `company` StreemApiCompany
    - `sid` string
    - `code` string
    - `name` string
    - `active` boolean
    - `parent_company_sid` string
    - `sub_company_limit` integer
    - `created_at` string, date-time
    - `active_status_modified_at` string, date-time
    - `call_sources` StreemApiCallSource[]
      - `sid` string
      - `company_id` string
      - `code` string
      - `name` string
      - `is_default` boolean
      - `logo_url` string
      - `max_diagnoses` integer
      - `custom_theme` StreemApiCustomTheme
        - `primary_color` string
  - `oidc_issuer` string
  - `owner_user` StreemApiUser
    - `sid` string
    - `company_sid` string
    - `external_user_id` string
    - `is_expert` boolean
    - `email` string
    - `name` string
    - `avatar_url` string
    - `phone` string
    - `active` boolean
    - `roles` string[]
    - `active_status_modified_at` string, date-time
    - `user_types` string[]
    - `deleted` boolean
    - `deleted_at` string, date-time
    - `bio` string
    - `availability_status` 'AVAILABILITY_STATUS_AVAILABLE' | 'AVAILABILITY_STATUS_NOT_AVAILABLE' | 'AVAILABILITY_STATUS_RESERVED' | 'AVAILABILITY_STATUS_IN_CALL' | 'AVAILABILITY_STATUS_CONFIRMING' | 'AVAILABILITY_STATUS_OFFLINE' | 'AVAILABILITY_STATUS_INVALID'

## Other responses

- `400` — Either you did not provide a company name, owner name, or owner email address, or the owner email address is invalid. Ensure you are providing 'owner_name` and 'owner_email` if attempting to create a Company or Sub-Company.
- `403` — Either you do not have permission to create a Company, or the limit of Sub-Companies has been reached. Ensure you are providing `parent_company_sid` if attempting to create a Sub-Company.
- `409` — There is already a Company with the provided `code`. Company codes must be unique within the entire system, since they map to URLs for that Company.

---

[API](https://skmtc.net/streem/apis/streem-api.md) · [All operations](https://skmtc.net/streem/apis/streem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streem/streem-api/versions/04250faebd19/schema)