POST/tasklists/{id}/tasks.json

Create a Task

For the specified task list, creates a task.


To add a custom field to a task, you pass in the custom field object to this endpoint. The custom field must already be created, you can do that by using V3 Custom Fields. Once the custom field is created, it’s available to attach a task. See sample payload below.

To update or delete custom fields from a task pass an empty array for the customFields param. Example on Updating a task.

To test that the custom field was added, you need to use the V2 tasks endpoint with "includeCustomFields=true" to return the custom fields and their values.


Path Params

  • Name
    id
    Type
    string
    required
    Description

Body Params

    • Name
      todo-item
      Type
      object

    Responses

    • Code
      201
      Type
      object
      Schema
      Description
      201 Response

    Examples

    201 Response

    application/json
    {
      "affectedTaskIds": "1",
      "id": "123",
      "STATUS": "OK"
    }