Todoist modules

48 min

After connecting to the Todoist app, you can use the following modules to build your scenarios.

If you receive a [429] Too many requests error, the Todoist API rate limit has been reached. To prevent the scenario from failing, add a Sleep module before retrying the request. This gives Todoist enough time to reset the limit and helps your scenario run more reliably.

Events

Watch new events

Triggers when a new event occurs on Todoist.

Webhook name	Enter the name for the webhook. E.g. Task added.
Account	Establish a connection to your Todoist account.
Group	Select whether you want to watch for task, project, or comment events.
Watch events	Select Todoist events that trigger the Make New Event module.

Projects

List projects

Returns a list of new projects.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Limit	Set the maximum number of projects Make will return during one execution cycle.

Get a project

Returns information about a project.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Project ID	Enter (map) the Project ID of the project you want to retrieve information about.

Create a project

Creates a new project.

Required Permissions: data:read_write

Some modules may need you to extend your permissions. Click on the Continue button and then on the Agree button to extend permissions.

Connection	Establish a connection to your Todoist account.
Name	Enter the name for the new project.
Parent project	Select the parent project if you don't want to create a root project.

Update a project

Updates a project.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Project ID	Enter (map) the project ID of the project you want to change.

Please find the field descriptions in the Create a Project section above.

Delete a project

Deletes a project.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Project ID	Enter (map) the project ID of the project you want to delete.

Labels

List labels

Returns a list of labels.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Limit	Set the maximum number of labels Make will return during one execution cycle.

Get a label

Retrieves information about a label.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Label ID	Enter (map) the Label ID of the label you want to retrieve information about.

Create a label

Creates a label.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Name	Enter a name for the new label.

Update a label

Changes the name of the label.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Label ID	Enter (map) the label ID of the label you want to edit.
Name	Enter a new name for the label.

Delete a label

Deletes a label.

Required Permissions: data:delete

Connection	Establish a connection to your Todoist account.
Label ID	Enter (map) the Label ID of the label you want to delete.

Tasks

List uncompleted tasks

Lists all uncompleted tasks.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Query	Enter a keyword or phrase to list the tasks that match the specified tasks.
Project	Select or map the project whose incomplete tasks you want to list.
Limit	Set the maximum number of tasks Make should return during one execution cycle.

Get a task

Retrieves details about a specified task.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to retrieve information about.

Create a task

Creates a new task.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Content	Enter the task content.
Project	Select the project or map the task ID. If not set, the task is put into the user’s Inbox.
Labels	Select the labels you want to associate with the task.
Due date	Date Enter the date in YYYY-MM-DD format or YYYY-MM-DDTHH:MM:SS.
Priority	Select the task priority.
Parent ID	Enter the ID of the parent task. Leave the field empty for root tasks.
Responsible	Select the user who is responsible for accomplishing the current task. This works for shared projects only.
Assigned by	Select the user who has assigned this task. This works for shared projects only.
Auto reminder	When this option is enabled, the default reminder will be added to the task if it has a due date with a time set.

Update a task

Edits a specified task.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to update.

Please find the descriptions of the fields in the Create a task section above.

Delete a task

Required Permissions: data:delete

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to delete.

Complete a task

Completes a task and all its descendants.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to set as complete.
Date completed	Enter the date of completion of the task (in UTC). If left empty, the server will set the value to the current time.

Complete a recurring task

Completes a recurring task.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to set as complete.
Due	Enter the due date of the task. Human-readable due date: Human-readable representation of due date. For example, every Morning, every other week. For details, see the Todoist’s introduction to recurring dates Due date: Enter the due date of the recurring task. Examples: 15.01.2026 or 2026-01-15 Time zone: Europe/Prague

Close a task

Closes a task. Regular task is completed and moved to history, subtask is checked (marked as done, but not moved to history), recurring task is moved forward (due date is updated).

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to close.

Uncomplete a task

Uncompletes a task.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to set as uncomplete.

Move a task

Moves a task.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Task ID	Enter (map) the Task ID of the task you want to move.
Project	Enter (map) the target location.
Parent ID	Enter the ID of the destination parent task.

Comments

List comments

Returns a list of comments.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Comments for	Select if you want to list comments for a task or project.
Task	Select the task you want to list comments from.
Project	Select the project you want to list comments from.
Limit	Set the maximum number of comments Make will return during one execution cycle.

Get a comment

Returns information about a comment.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Comment ID	Enter (map) the ID of the comment you want to retrieve information about.

Create a comment

Creates a comment.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Comment for	Select if you want to create a comment for a task or project.
Project	Select the project you want to add the comment to.
Task	Select the task you want to add the comment to.
Content	Enter the text content of the comment.
File Attachment	File URL: Enter the URL of the file you want to attach to the comment. File name: Enter the file name.
Users to notify	Select users who will be notified when the comment is added.

Update a comment

Changes the content of the comment.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Comment ID	Enter (map) the ID of the comment you want to update.
Content	Enter the new text for the comment.
File Attachment	Map the field values using the Upload a File module. File URL: Enter the URL of the file you want to attach to the comment. File name: Enter the file name.

Delete a comment

Deletes a comment.

Required Permissions: data:delete

Connection	Establish a connection to your Todoist account.
Comment ID	Enter (map) the ID of the comment you want to delete.

Filters

List filters

Returns a list of filters.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Limit	Set the maximum number of filters Make will return during one execution cycle.

Create a filter

Creates a filter.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Name	Enter a name for the filter.
Query	Set the query of the filter. For example (today \| overdue) & #Work. For details, see the Todoist Introduction to filters.
Color	Select the color of the filter.
Is favorite	Select whether the filter will be added under the favorites.
Filter order	Enter (map) the filter's position in the filter list (lower values appear higher).

Update a filter

Updates a filter.

Connection	Establish a connection to your Todoist account.
Filter ID	Enter (map) the ID of the filter you want to update.
Name	Enter the name you want to update the filter to.
Query	Set the query of the filter. For example (today \| overdue) & #Work. For details, see the Todoist Introduction to filters.
Color	Select the color of the filter.
Is favorite	Select whether the filter will be added under the favorites.
Filter order	Enter (map) the filter's position in the filter list (lower values appear higher).

Delete a filter

Deletes a filter.

Required Permissions: data:delete

Connection	Establish a connection to your Todoist account.
Filter ID	Enter (map) the ID of the filter you want to delete.

Sections

List sections

Returns a list of sections.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.
Limit	Set the maximum number of sections Make will return during one execution cycle.

Create a section

Creates a section.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Name	Enter a name for the section.
Project	Select the project where you want to create the section.
Section order	Enter (map) the order of the section. It defines the position of the section among all the sections in the project.

Update a section

Updates a section.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Section ID	Enter (map) the ID of the section you want to update.
Name	Enter the name you want to update the section to.

Delete a section

Deletes a section.

Required Permissions: data:delete

Connection	Establish a connection to your Todoist account.
Section ID	Enter (map) the ID of the section you want to delete.

Import and Export

Import tasks

Imports a tasks into a selected project.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Project	Select the project where you want to import tasks.
File	Enter (map) file name and the data (.csv)

Export tasks as a file

Exports tasks as a csv file.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Project	Select the project where you want to export tasks as a csv file from.

Export tasks as shareable URL

Exports tasks as shareable URL.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Project	Select the project where you want to exports tasks as shareable URLs.

Other

Upload a file

Allows you to upload a file with the Create a Task Comment and/or the Create a Project Comment modules.

Required Permissions: data:read_write

Connection	Establish a connection to your Todoist account.
Source File	Map the file using the previous module (e.g. Dropbox > Get a File), or enter a file name and data manually.

Get stats

Retrieves productivity stats.

Required Permissions: data:read

Connection	Establish a connection to your Todoist account.

Make an API call

Sends a custom API call to Todoist. You can use this module to call endpoints that aren't covered by existing modules.

Connection	Establish a connection to your Todoist account.
URL	Enter a path relative to https://api.todoist.com/ (e.g. /rest/v1/tasks or /sync/v8/sync) For the list of available endpoints, refer to the Todoist REST API Documentation or Todoist Sync API Documentation.
Method	Select the HTTP method you want to use: GET: to retrieve information for an entry. POST: to create a new entry. PUT: to update/replace an existing entry. PATCH: to make a partial entry update. DELETE: to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of Use - Get Active Tasks

The following API call returns the list of all active tasks in your Todoist account:

Matches of the search can be found in the module's Output under Bundle > Body.

In our example, 3 active tasks were returned: