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

# Add a project

`POST /projects`

Adds a new project. Note that you can supply additional custom fields along with the request that are not described here. These custom fields are different for each Pipedrive account and can be recognized by long hashes as keys.

## Request body

- object
  - `title` string, required — The title of the project
  - `board_id` number — The ID of the board this project is associated with
  - `phase_id` number — The ID of the phase this project is associated with
  - `description` string — The description of the project
  - `status` string — The status of the project
  - `owner_id` number — The ID of a project owner
  - `start_date` string, date — The start date of the project. Format: YYYY-MM-DD.
  - `end_date` string, date — The end date of the project. Format: YYYY-MM-DD.
  - `deal_ids` integer[] — An array of IDs of the deals this project is associated with
  - `org_id` number — The ID of the organization this project is associated with
  - `person_id` number — The ID of the person this project is associated with
  - `labels` integer[] — An array of IDs of the labels this project has
  - `health_status` integer, nullable — The health status of the project
  - `template_id` number — The ID of the template the project will be based on

## Response `201`

Created project.

- object
  - `success` boolean
  - `data` object
    - `id` integer — The ID of the project, generated when the task was created
    - `title` string — The title of the project
    - `board_id` number — The ID of the board this project is associated with
    - `phase_id` number — The ID of the phase this project is associated with
    - `description` string — The description of the project
    - `status` string — The status of the project
    - `owner_id` number — The ID of a project owner
    - `start_date` string, date — The start date of the project. Format: YYYY-MM-DD.
    - `end_date` string, date — The end date of the project. Format: YYYY-MM-DD.
    - `deal_ids` integer[] — An array of IDs of the deals this project is associated with
    - `org_id` number — The ID of the organization this project is associated with
    - `person_id` number — The ID of the person this project is associated with
    - `labels` integer[] — An array of IDs of the labels this project has
    - `health_status` integer, nullable — The health status of the project
    - `add_time` string — The creation date and time of the project in UTC. Format: YYYY-MM-DD HH:MM:SS.
    - `update_time` string — The update date and time of the project in UTC. Format: YYYY-MM-DD HH:MM:SS.
    - `status_change_time` string — The status changed date and time of the project in UTC. Format: YYYY-MM-DD HH:MM:SS.
    - `archive_time` string — The archived date and time of the project in UTC. Format: YYYY-MM-DD HH:MM:SS. If not archived then 'null'.
  - `additional_data` object, nullable

---

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