---
title: "Creates or update a project"
method: POST
path: "/rest/v2/projects"
---

# Creates or update a project

`POST /rest/v2/projects`

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

## Request body

- object
  - `projectId` string — The id of the project you want to update.
  - `name` string — The name of the project you want to update/create.
  - `externalId` string — The id of the project you want to update in your system.
  - `isMadeForRecruitment` boolean — Whether the project is made for recruitment, and should be displayed in the ATS
  - `isMadeForSales` boolean — Whether the project is made for sales, and should be displayed in the CRM
  - `createdAt` string — The date of creation of the project
  - `assignees` string — The assignees of the project
  - `statusId` string — The status of the project
  - `companyId` string — The company of the project
  - `colorId` string — The color of the project
  - `customFieldsValues` object — Custom fields values for the project. The key should be the field ID and the value can be any text value.

## Response `201`

The application has been saved

- object
  - `message` string
  - `taskId` string
  - `projectId` 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)
