---
title: "Add a new company"
method: POST
path: "/companies"
tags: ["Company API:Companies"]
---

# Add a new company

`POST /companies`

## Headers

- `X-Allow-Duplicates` string

## Request body

- AddCompanyCommand
  - `name` string, required
  - `parentCompanyId` integer, nullable
  - `summary` string, nullable
  - `legalName` string, nullable — Company LegalName
  - `social` object, nullable
  - `statusId` integer, nullable — Company status
  - `custom` SubmitCustomFieldValueModel[], nullable — Custom field values. Only the specified fields will be updated, each fieldId can specified once.
    - `fieldId` integer, required
    - `value` unknown
  - `ownerUserId` integer, nullable
  - `recruiterUserId` integer[], nullable

## Response `201`

Created

- CompanyRepresentation
  - `companyId` integer, required — Unique identifier for the company
  - `name` string, nullable — Company name
  - `status` StatusModel
    - `statusId` integer, required
    - `name` string, required
    - `active` boolean
    - `default` boolean
  - `mainContact` ContactNameModel
    - `contactId` integer, required — Unique identifier for the contact
    - `firstName` string, nullable — First name
    - `lastName` string, nullable — Last name
    - `position` string, nullable — Position or job title
    - `salutation` string, nullable — Salutation/honorific/title
    - `unsubscribed` boolean
    - `email` string, nullable — Primary email address
    - `phone` string, nullable — Phone number
    - `mobile` string, nullable — Mobile/cell number
    - `mobileNormalized` string, nullable — Mobile/cell normalized number
    - `inactive` boolean — Contact is no longer with the company
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `primaryAddress` CompanyAddressModel
    - `addressId` string, uuid, required
    - `name` string, nullable
    - `street` string[], nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `country` string, nullable
    - `countryCode` string, nullable
    - `phone` string, nullable
    - `fax` string, nullable
    - `url` string, uri, nullable
  - `legalName` string, nullable
  - `social` object, nullable — Company social profiles
  - `summary` string, nullable
  - `parent` CompanyNameModel
    - `companyId` integer, required — Unique identifier for the company
    - `name` string, nullable — Company name
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `custom` CustomFieldValueModel[], nullable
    - `fieldId` integer, required
    - `name` string, required
    - `type` 'Text' | 'List' | 'Date' | 'Lookup' | 'Url', string, required — The type of value a custom field expects
    - `value` unknown
  - `owner` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `recruiters` UserNameModel[], nullable
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `partnerActions` PartnerActionStageModel[], nullable
    - `actionId` string, uuid
    - `actionName` string, nullable
    - `reference` string, nullable — Unique partner defined reference/identifier for the action
    - `stage` 'Submitted' | 'InProgress' | 'Completed' | 'Rejected' | 'Cancelled', string
    - `status` string, nullable — Partner defined progress status message for the action
    - `result` PartnerActionResultModel
      - `score` integer, nullable — Optional partner score for the action result
      - `url` string, uri, nullable — Optional partner defined URL for the action result
      - `urlType` 'Popup' | 'Page', string
    - `submittedAt` string, date-time
    - `submittedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `updatedAt` string, date-time
    - `updatedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `createdBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `createdAt` string, date-time, nullable
  - `updatedBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `updatedAt` string, date-time, nullable
  - `links` CompanyLinks
    - `self` string, uri, nullable
    - `logo` string, uri, nullable — Company logo
    - `contacts` string, uri, nullable — Company contacts
    - `subsidiaries` string, uri, nullable — Company subsidiaries
    - `addresses` string, uri, nullable — Company addresses
    - `skills` string, uri, nullable — Skills
    - `notes` string, uri, nullable — Company notes
    - `attachments` string, uri, nullable — Attachments
    - `jobs` string, uri, nullable — Company jobs
    - `requisitions` string, uri, nullable — Company requisitions
    - `floats` string, uri, nullable — Company floats
    - `submissions` string, uri, nullable — Company submissions
    - `placements` string, uri, nullable — Company placements
    - `workflows` CompanyWorkflowLinks
      - `requisition` string, uri, nullable

## Other responses

- `409` — Company with this name already exists
- `422` — Validation error

---

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