---
title: "Create a project"
method: POST
path: "/projects"
tags: ["Projects"]
---

# Create a project

`POST /projects`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/projects`
- Auth: HTTP bearer

Create a new project.

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `code` string: Project code
  - `color` string: Project color
  - `description` string: Description of project
  - `end_date` string, date: Project end date
  - `name` string, required: The project name.
  - `parent_id` string, uuid: Parent project ID
  - `partner_metadata` object: Project metadata
  - `start_date` string, date: Project start date
  - `tag_ids` string[]: A list of IDs of user-defined tags (labels) assigned to this project.

## Response `201`

Successful Response

- ProjectResource
  - `id` string, uuid, required: A unique ID assigned to this project.
  - `created_at` string, date-time, required: Project created at
  - `updated_at` string, date-time, required: Last time project was updated at
  - `code` string: Project code
  - `color` string: Project color
  - `created_by_entity_user_id` string, uuid: Project created by entity user
  - `description` string: Description of project
  - `end_date` string, date: Project end date
  - `entity_id` string, uuid, required: The ID of the entity to which the project was issued.
  - `name` string, required: The project name.
  - `parent_id` string, uuid: Parent project ID
  - `partner_metadata` object: Project metadata
  - `start_date` string, date: Project start date
  - `tags` TagReadSchema[]: A list of user-defined tags (labels) assigned to this project.
    - `id` string, uuid, required: A unique ID of this tag.
    - `created_at` string, date-time, required: Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `updated_at` string, date-time, required: Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
    - `created_by_entity_user_id` string, uuid: ID of the user who created the tag.
    - `description` string: The tag description.
    - `name` string, required: The tag name.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)