PIpipedrive
Projects

Add a project

Changed on

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.

post/projects

Request

  • Base URL
    https://api.pipedrive.com/v1
  • Auth
    • API key in header x-api-token
    • or OAuth 2
      Authorization code: https://oauth.pipedrive.com/oauth/authorize
      Token URL: https://oauth.pipedrive.com/oauth/token scopes: projects:full

Request body

titlestring required

The title of the project

board_idnumber

The ID of the board this project is associated with

phase_idnumber

The ID of the phase this project is associated with

descriptionstring

The description of the project

statusstring

The status of the project

owner_idnumber

The ID of a project owner

start_datestring date

The start date of the project. Format: YYYY-MM-DD.

end_datestring date

The end date of the project. Format: YYYY-MM-DD.

deal_idsinteger[]

An array of IDs of the deals this project is associated with

org_idnumber

The ID of the organization this project is associated with

person_idnumber

The ID of the person this project is associated with

labelsinteger[]

An array of IDs of the labels this project has

health_statusinteger nullable

The health status of the project

template_idnumber

The ID of the template the project will be based on

Response

Created project.

successboolean
additional_dataobject nullable

Changes

  • bf863a979545Revision changes
    • info

      added the new optional request property /

    • info

      added the optional property /// to the response with the status

  • 24d2d929aac3Revision changes
    • warning

      removed the request property /

    • warning

      removed the request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added subschema #1 subschema #2 to the / response property allOf list for the response status

    • info

      removed subschema #1 subschema #2 from the / response property allOf list for the response status