Todoist

Manage tasks, projects, labels, and comments in the Todoist task manager.

Detail	Value
Category	Productivity
Base URL	https://api.todoist.com/rest/v2
Authentication	Bearer Token
Endpoints	5
Connector key	todoist

Using Todoist in a workflow

1. Go to Connections and click New Connection.
2. Pick Todoist from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /tasks	Get active tasks
POST /tasks	Create a task
POST /tasks/{taskId}/close	Complete a task
GET /projects	List projects
POST /projects	Create a project

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /tasks

Get active tasks

Detail	Value
Operation ID	productivity.listTasks
Method	GET
Path	/tasks

Parameters

Name	Location	Type	Required
project_id	query	string	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Todoist connection from the Connection dropdown.
3. In the Operation dropdown, select productivity.listTasks.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Todoist API reference.

POST /tasks

Create a task

Detail	Value
Operation ID	productivity.createTask
Method	POST
Path	/tasks

Parameters

No parameters.

Request Body

Field	Type
content	string
priority	integer

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Todoist connection from the Connection dropdown.
3. In the Operation dropdown, select productivity.createTask.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Todoist API reference.

POST /tasks/{taskId}/close

Complete a task

Detail	Value
Operation ID	productivity.closeTask
Method	POST
Path	/tasks/{taskId}/close

Parameters

Name	Location	Type	Required
taskId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Todoist connection from the Connection dropdown.
3. In the Operation dropdown, select productivity.closeTask.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Todoist API reference.

GET /projects

List projects

Detail	Value
Operation ID	productivity.listProjects
Method	GET
Path	/projects

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Todoist connection from the Connection dropdown.
3. In the Operation dropdown, select productivity.listProjects.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Todoist API reference.

POST /projects

Create a project

Detail	Value
Operation ID	productivity.createProject
Method	POST
Path	/projects

Parameters

No parameters.

Request Body

Field	Type
name	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Todoist connection from the Connection dropdown.
3. In the Operation dropdown, select productivity.createProject.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Todoist API reference.