---
title: "company"
method: POST
path: "/v{version}/companies"
tags: ["Company"]
---

# company

`POST /v{version}/companies`

Returns the id of the company created.<p>Scopes: import_plan, update_company</p>

## Path parameters

- `version` string, required

## Query parameters

- `new_companies_only` boolean

## Request body

- DtosPlanCompany
  - `name` string, required — The name of the company.
  - `agent_email` string — The email address of the agent for the company.
  - `assign_agent_teams` boolean — Indicates whether or not to assign the agent's team to this company. This value is only respected if an agent is found for the provided agent_email, otherwise it is ignored.
  - `create_team_for_agent` boolean — Indicates whether or not to always create a new team for the agent, if it doesn't already exist. The default is true.
  - `ein` string — The EIN of the company.
  - `sic` string — The SIC of the company.
  - `default_pay_cycle_periods` integer — The number of pay cycles for all employees per year, by default. Accepted values are 1-52.
  - `locations` DtosPlanLocation[] — All company locations
    - `location_id` string, required — The id of the location.
    - `name` string, required — The name of the location.
    - `address` DtosAddress, required
      - `addr1` string — The street address.
      - `addr2` string — Secondary field for street address.
      - `city` string — The city.
      - `state` string — The state. Can be the 2 letter state abbreviation or the full state name.
      - `zip` string — The postal code.
      - `county` string — The county.
      - `country` 'Afghanistan' | 'Albania' | 'Algeria' | 'Argentina' | 'Armenia' | 'Australia' | 'Austria' | 'Azerbaijan' | 'Bahrain' | 'Bangladesh' | 'Belarus' | 'Belgium' | 'Belize' | 'Benin' | 'Bhutan' | 'Bolivarian Republic of Venezuela' | 'Bolivia' | 'Bosnia and Herzegovina' | 'Botswana' | 'Brazil' | 'Brunei Darussalam' | 'Bulgaria' | 'Burundi' | 'Cambodia' | 'Cameroon' | 'Canada' | 'Caribbean' | 'Chile' | 'Colombia' | 'Congo (DRC)' | 'Costa Rica' | 'Côte d'Ivoire' | 'Croatia' | 'Cuba' | 'Cyprus' | 'Czech Republic' | 'Denmark' | 'Djibouti' | 'Dominican Republic' | 'Ecuador' | 'Egypt' | 'El Salvador' | 'Eritrea' | 'Estonia' | 'Ethiopia' | 'Faroe Islands' | 'Fiji' | 'Finland' | 'France' | 'Gambia' | 'Georgia' | 'Germany' | 'Ghana' | 'Greece' | 'Greenland' | 'Guatemala' | 'Haiti' | 'Honduras' | 'Hong Kong S.A.R.' | 'Hungary' | 'Iceland' | 'India' | 'Indonesia' | 'Iran' | 'Iraq' | 'Ireland' | 'Islamic Republic of Pakistan' | 'Israel' | 'Italy' | 'Jamaica' | 'Japan' | 'Jordan' | 'Kazakhstan' | 'Kenya' | 'Korea' | 'Kuwait' | 'Kyrgyzstan' | 'Lao P.D.R.' | 'Latin America' | 'Latvia' | 'Lebanon' | 'Liberia' | 'Libya' | 'Liechtenstein' | 'Lithuania' | 'Luxembourg' | 'Macao S.A.R.' | 'Malaysia' | 'Maldives' | 'Mali' | 'Malta' | 'Mexico' | 'Moldova' | 'Mongolia' | 'Montenegro' | 'Morocco' | 'Myanmar' | 'Namibia' | 'Nepal' | 'Netherlands' | 'New Zealand' | 'Nicaragua' | 'Nigeria' | 'North Macedonia' | 'Norway' | 'Oman' | 'Palestine' | 'Panama' | 'Paraguay' | 'People's Republic of China' | 'Peru' | 'Philippines' | 'Poland' | 'Portugal' | 'Principality of Monaco' | 'Puerto Rico' | 'Qatar' | 'Réunion' | 'Romania' | 'Russia' | 'Rwanda' | 'Saudi Arabia' | 'Senegal' | 'Serbia' | 'Sierra Leone' | 'Singapore' | 'Slovakia' | 'Slovenia' | 'Somalia' | 'South Africa' | 'Spain' | 'Sri Lanka' | 'Sudan' | 'Sweden' | 'Switzerland' | 'Syria' | 'Taiwan' | 'Tajikistan' | 'Tanzania' | 'Thailand' | 'Trinidad and Tobago' | 'Tunisia' | 'Turkey' | 'Turkmenistan' | 'U.A.E.' | 'Uganda' | 'Ukraine' | 'United Kingdom' | 'United States' | 'Uruguay' | 'Uzbekistan' | 'Vietnam' | 'Yemen' | 'Zambia' | 'Zimbabwe' — The country.
      - `region` string — The region.
    - `phone` string — The phone number of the location.
    - `fax` string — The fax number of the location.
    - `headquarters` boolean — A boolean representing whether or not this location is the headquarters for the company.
  - `carrier_settings` DtosPlanCompanyCarrierSettings[] — Carrier specific metadata fields.
    - `carrier` string
    - `field` string
    - `value` unknown

## Response `200`

Success

- ControllersCompanyControllerModel
  - `id` string, required

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)