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

# Create company

`POST /api/v1/companies/company`

## Request

- Base URL: `https://api.getprospect.com`
- URL: `https://api.getprospect.com/api/v1/companies/company`
- Auth: API key in header `apiKey`
- TypeScript: <https://skmtc.dev/getprospect/apis/calls/docs/api/v1/companies/company/post.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint creates a new company.

## Request body

- CreateCompanyDto
  - `properties` PropertyItem[], required
    - `property` string, required
    - `value` string, required

## Response `201`

Entity created

- CompanyResponse
  - `data` CompanyModel, required
    - `_id` ObjectId, required
    - `owner` ObjectId, required
    - `properties` object, required
    - `source` 'crm' | 'insights' | 'linkedin-plugin' | 'linkedin-plugin-fastmode' | 'integration' | 'api' | 'import', required
    - `workspaceId` number, required
    - `search` ObjectId, required
    - `insightId` ObjectId, required
    - `linkedin` ContactLinkedin[], required
      - `id` string, required
      - `type` 'common' | 'sales', required
    - `deleted` boolean, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `keywords` string[], required
    - `foundedAt` number, required
    - `companyType` 'education' | 'government' | 'nonprofit' | 'private' | 'public', required

## Other responses

- `400`: Bad model
- `401`: Unauthorized user

---

[API](https://skmtc.dev/getprospect/apis/calls.md) - [All operations](https://skmtc.dev/getprospect/apis/calls/llms.txt) - [OpenAPI document](https://skmtc.dev/getprospect/apis/calls/revisions/5211a12644da?raw)