--- title: Todoist modules slug: todoist-modules createdAt: 2026-02-06T10:32:20.430Z --- After connecting to the Todoist app, you can use the following modules to build your scenarios. :::hint{type="info"} 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](https://help.make.com/util#sleep) 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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | --------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ------------------ | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **Project ID** | Enter (map) the project ID of the project you want to change. | Please find the field descriptions in the [Create a Project ](docId\:HSkfy6bXd9G2R7gkI8-R-) section above. ### Delete a project Deletes a project. **Required Permissions:** data\:read\_write | **Connection** | [Establish a connection to your Todoist account.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ----------------- | ----------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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](docId\:HSkfy6bXd9G2R7gkI8-R-) section above. ### Delete a task **Required Permissions:** data\:delete | **Connection** | [Establish a connection to your Todoist account.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ------------------ | --------------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **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](https://www.todoist.com/help/articles/introduction-to-recurring-dates-YUYVJJAV)
- **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ---------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ------------------- | ----------------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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](https://www.todoist.com/help/articles/introduction-to-filters-V98wIH). | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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](https://www.todoist.com/help/articles/introduction-to-filters-V98wIH). | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ----------------- | ------------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | --------------- | --------------------------------------------------------------------------------------------------------------- | | **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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | -------------- | ------------------------------------------------------------------------------- | ### 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.](docId\:HSkfy6bXd9G2R7gkI8-R-) | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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](https://developer.todoist.com/rest/) or [Todoist Sync API Documentation.](https://developer.todoist.com/sync/) | | **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: ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/wmEXUflMgsYsAEA5EpNAY_uuid-476be1d3-1e7e-3385-15e5-f7c9c71ccfb8.png" size="50" width="399" height="841" position="center" darkWidth="399" darkHeight="841" showCaption="false"} Matches of the search can be found in the module's Output under Bundle > Body. In our example, 3 active tasks were returned: ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/PI8utctkoXMOE0ggCboWY_uuid-8f2c0fce-b5e8-2ea7-59b6-4fe7ff4c8bc6.png" size="50" width="397" height="484" position="center" darkWidth="397" darkHeight="484" showCaption="false"}