API Reference

Create Task

Create a new task.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Path Params
number
required
Query Params
boolean

If you want to reference a task by its custom task id, this value must be true.

number

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.

For example: custom_task_ids=true&team_id=123.

Body Params
string
required
string
array of integers
assignees
boolean
array of strings

Assign multiple user groups to the task.

group_assignees
array of strings
tags
string
integer | null
integer
boolean
integer
integer
boolean
number

Add Sprint Points to the task.

boolean

If notify_all is true, notifications will be sent to everyone including the creator of the comment.

string | null

You can create a subtask by including an existing task ID.

The parent task ID you include can be a subtask, but must be in the same List specified in the path parameter.

string

Markdown formatted description for the task. If both markdown_content and description are provided, markdown_content will be used instead of description.

string | null
boolean

When creating a task via API any required Custom Fields are ignored by default (false).

You can enforce required Custom Fields by including check_required_custom_fields: true.

array of objects
custom_fields
number

The custom task type ID for this task. A value of null (default) creates a standard task type "Task".

To get a list of available custom task type IDs for your Workspace, use the Get Custom Task Types endpoint.

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json