PIpipedrive
Tasks

Add a task

Changed on

Adds a new task.

post/tasks

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 task

project_idnumber required

The ID of a project

descriptionstring

The description of the task

parent_task_idnumber

The ID of a parent task. Can not be ID of a task which is already a subtask.

assignee_idnumber

The ID of the user assigned to the task. When the assignee_id field is updated, the assignee_ids field value will be overwritten by the assignee_id field value.

assignee_idsnumber[]

The IDs of users assigned to the task. When the assignee_ids field is updated, the assignee_id field value will be set to the first value of the assignee_ids field, or null if the list is empty.

done0 | 1

Whether the task is done or not. 0 = Not done, 1 = Done.

due_datestring date

The due date of the task. Format: YYYY-MM-DD.

Response

Created task.

successboolean
additional_dataobject nullable

Changes

  • b57708cb0b44Revision changes
    • info

      added the new optional request property /

    • info

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

  • 24d2d929aac3Revision changes
    • breaking

      added subschema #1: requiredPostProjectParameters to the request body allOf list

    • warning

      removed subschema #1: requiedPostProjectParameters from the request body allOf list