---
title: "Creates or update a company"
method: POST
path: "/rest/v2/companies"
---

# Creates or update a company

`POST /rest/v2/companies`

Save a company in Jarvi. It creates the company if it does not exist, updates it if it does.

## Request body

- object
  - `name` string — The name of the company
  - `description` string — The description of the company
  - `linkedinUrl` string — The linkedin url of the company
  - `companyId` string — The id of the company you want to update.
  - `externalId` string — The id of the company you want to update in your system.
  - `assignees` string — The assignees of the company
  - `statusId` string — The status of the company

## Response `201`

The application has been saved

- object
  - `message` string
  - `taskId` string
  - `companyId` string

## Other responses

- `400` — Cannot save profile, see details
- `500` — Unknown error

---

[API](https://skmtc.dev/jarvi/apis/jarvi-api.md) · [All operations](https://skmtc.dev/jarvi/apis/jarvi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jarvi/jarvi-api/revisions/5e58e46c5036/schema)