STstreakyc
Tasks

Create task

Changed on

Creates a task on a box.

post/v2/boxes/{boxKey}/tasks

Request

  • Base URL
    https://api.streak.com/api
  • URL
    https://api.streak.com/api/v2/boxes/{boxKey}/tasks
  • Auth
    HTTP bearer

Path parameters

boxKeystring required

Key for the box to create the task on.

Request body

textstring required

Task text.

dueDateinteger nullable

Task due date, in epoch milliseconds. Use -1 to create a task with no due date.

meetingKeystring nullable

Key for the meeting this task belongs to, when any.

isDraftboolean nullable

Whether to create this task as a draft. Draft tasks do not send notifications or webhooks.

teamContactKeystring nullable

Key for the contact used to infer suggested task actions.

draftboolean

Example request

{
  "dueDate": 1646870400000
}

Response

OK

keystring required

Key for this task.

boxKeystring required

Key for the box this task belongs to.

pipelineKeystring required

Key for the pipeline this task belongs to.

creatorKeystring required

Key for the user who created this task.

creationDateinteger required

Timestamp when this task was created, in epoch milliseconds.

lastSavedTimestampinteger required

Timestamp when this task was last persisted, in epoch milliseconds.

lastStatusChangeDateinteger required

Timestamp when this task status last changed, in epoch milliseconds.

dueDateinteger nullable

Task due date, in epoch milliseconds.

textstring required

Task text.

status'NOT_DONE' | 'DONE' required
reminderStatus'NONE' | 'SCHEDULED' | 'REMINDED' | 'ERROR_ON_REMINDER' | 'NOT_REMINDED_BECAUSE_TASK_DONE' required
meetingKeystring nullable

Key for the meeting this task belongs to, when any.

Example response

{
  "creationDate": 1646870400000,
  "lastSavedTimestamp": 1646870400000,
  "lastStatusChangeDate": 1646870400000,
  "dueDate": 1646870400000,
  "actions": [
    {
      "contact": {
        "creationDate": 1646870400000,
        "versionTimestamp": 1646870400000,
        "lastSavedTimestamp": 1646870400000,
        "lastEnrichmentTimestamp": 1646870400000,
        "contactLinks": [
          {
            "creationTimestamp": 1646870400000
          }
        ],
        "orgLinks": [
          {
            "creationTimestamp": 1646870400000
          }
        ]
      }
    }
  ]
}

Changes