Todoist (legacy)
Version Legacy
Getting Started with Todoist
This is the documentation for the legacy Todoist (legacy) app.
Here is the documentation for the new Todoist app.
Here is the documentation for the new Todoist app.
Prerequisites
- A Todoist account
In order to use Todoist with Integromat, it is necessary to have a Todoist account. If you do not have one, you can create a Todoist account at todoist.com.
Connecting Todoist to Integromat
To connect Todoist to Integromat you must connect your Todoist account to Integromat. To do so, follow the general instructions for Connecting to services.
After you click the Continue button, Integromat will redirect you to the Todoist website where you will be prompted to grant Integromat access to your account.
Confirm the dialog by clicking the Agree button.
Triggers
New Event
Triggers when a task event, project event, or comment event is performed.
| Webhook name | Enter a name for the webhook connection. |
| Account | Establish a connection to your Todoist account. |
| Group | Use the drop-down menu to select whether you want to monitor changes in Tasks, Projects, or Comments. |
| Watch events | Select events performed in Todoist that will trigger this module. |
Actions
Add a task
| Account | Establish a connection to your Todoist account. |
| Project | Select the project you want to create a task for. |
| Labels | Select the label(s) you want to assign to the task. |
| Collaborator ID | Select the user you want to share the task with. |
| Content | Enter the content of the new task. |
| Date | Enter a due date. For more information about supported formats refer to the Todoist Due Date and Time documentation. |
| Priority | Set the priority from the drop-down menu. In the case of manual setting - the priority level is entered as a number between 1 and 4. The Todoist API, however, differs from the Todoist web application, the priority scales are reversed. The API uses 4 for very urgent tasks and 1 for natural tasks. E.g. If you want to set the priority p1 in the Todoist application, enter priority 4 in Integromat, if you want to give your task priority p2, it is necessary to enter 3 in Integromat, and etc. |
Update a Task
Updates an existing task.
| Account |
| |
| Labels | Select the label(s) you want to assign to the task. | |
| Collaborator ID | Select the user you want to share the task with. | |
| Task ID | Enter (map) the ID of a task you want to update. You can use the Search for a Task module to retrieve the Task ID. | |
| Content | Enter the updated content for the task. | |
| Date | Enter a due date. For more information about supported formats refer to the Todoist Due Date and Time documentation. | |
| Priority | Set the priority from the drop-down menu. In the case of manual setting - the priority level is entered as a number between 1 and 4. The Todoist API, however, differs from the Todoist web application, the priority scales are reversed. The API uses 4 for very urgent tasks and 1 for natural tasks. E.g. If you want to set the priority p1 in the Todoist application, enter priority 4 in Integromat, if you want to give your task priority p2, it is necessary to enter 3 in Integromat, and etc. |
Delete a Task
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter (map) the ID of the task you want to delete. The ID can be retrieved, for example, using the Search for a Task module. |
Complete a Task
Closes a task.
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter (map) the ID of the task you want to mark as completed. The ID can be retrieved, for example, using the Search for a Task module. |
Mark a Task Uncompleted
This module reopens a previously closed task. It works both with checked tasks in the user’s workspace and tasks moved to history. The behavior varies for different types of tasks (the command follows the behavior of official clients when tasks are uncompleted or extracted from the history).
- Regular tasks are extracted from the history and added back to the user workspace as normal unchecked tasks (without their subtasks though).
- Completed subtasks of a non-completed task are simply marked as uncompleted.
- Subtasks that were moved to history are added back to the workspace as first-level tasks.
- Non-completed recurring tasks are ignored.
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter (map) the ID of the task you want to re-open. The ID can be retrieved, for example, using the Search for a Task module. |
Get a Label
| Account | Establish a connection to your Todoist account. |
| Label ID | Enter (map) the ID of the label that you want to retrieve. The ID can be retrieved, for example, using the Search for a Task module. |
Create a Label
| Account | Establish a connection to your Todoist account. |
| Name | Enter a name for the new label. |
Update a Label
Changes the label name.
| Account | Establish a connection to your Todoist account. |
| Label ID | Enter (map) the ID of the label that you want to update. The ID can be retrieved, for example, using the Search for a Task module. |
| Name | Enter the new label name. |
Delete a Label
| Account | Establish a connection to your Todoist account. |
| Label ID | Enter (map) the ID of the label that you want to delete. The ID can be retrieved, for example, using the Search for a Task module. |
Add a Project
Creates a new project.
| Account | Establish a connection to your Todoist account. |
| Name | Enter a name for the new project. |
Update a Project
Changes the name of the project.
| Account | Establish a connection to your Todoist account. |
| Project ID | Enter (map) the ID of the project that you want to update. The ID can be retrieved, for example, using the Search for a Task module. |
| Name | Enter the new project name. |
Delete a Project
Deletes a project.
| Account | Establish a connection to your Todoist account. |
| Project ID | Enter (map) the ID of the project you want to delete. The ID can be retrieved, for example, using the Search for a Task module. |
Upload a File
Uploads a file.
This function is available only to Todoist Premium users.
| Account | Establish a connection to your Todoist account. |
| File name | Specify the name of the file you want to upload. Don't forget the filename extension. E.g. integromat_logo.png |
| Data | Enter (or map) a file data. More information about working with files. |
Add a Comment to a Task
Creates a new comment for a task.
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter the ID of the task you want to comment on. |
| Comment | Enter the desired comment. |
| Attachment file URL | Enter the URL of the file you want to attach with the comment. |
| Attachment file name | Enter (map) the attachment file name with extension. |
Update a Comment
| Account | Establish a connection to your Todoist account. |
| Comment ID | Enter (map) the ID of the comment you want to update. The ID can be retrieved, for example, using the Get Task Comments module. |
| Comment | Enter the new content for the comment. |
Delete a Comment
| Account | Establish a connection to your Todoist account. |
| Comment ID | Enter (map) the ID of the comment you want to delete. The ID can be retrieved, for example, using the Get Task Comments module. |
Add a Comment to a Project
Creates a new comment for a project.
| Account | Establish a connection to your Todoist account. |
| Project | Select the project you want to create a comment. |
| Comment | Enter the content of the new comment. |
| Attachment file URL | Enter the URL of the file you want to attach with the comment. |
| Attachment file name | Enter or map the attachment file name with an extension. |
Get Task Comments
Retrieves all comments for a selected task.
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter (map) the ID of the task you want to retrieve the comments from. The ID can be retrieved, for example, using the Search for a Task module. |
Get a Task
Returns an active (non-completed) task.
| Account | Establish a connection to your Todoist account. |
| Task ID | Enter (map) the ID of the task you want to retrieve the information about. The ID can be retrieved, for example, using the Search for a Task module. |
Get a Project
| Account | Establish a connection to your Todoist account. |
| Project ID | Enter (map) the ID of the project you want to retrieve the information about. The ID can be retrieved, for example, using the Search for a task module. |
Search for a Task
Searches for a phrase in a task.
| Account | Establish a connection to your Todoist account. |
| Project | Select the project that you want to search for a task. |
| Continue the execution of the scenario even if the module returns no tasks | If this option is enabled, the scenario flow will not get stopped by this module. |
| Maximum number of returned tasks | Enter the maximum number of returned tasks that Integromat will work with during one cycle (the number of repetitions per scenario run). |
| Phrase | Enter the keyword or sentence to search for the tasks that match the specified phrase. |
Get Stats
Retrieves a productivity report.
| Account | Establish a connection to your Todoist account. |
