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.

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.

2019-03-01_13_16_07-Window.png

Confirm the dialog by clicking the Agree button.

Triggers

New Event

Triggers when a task event, project event, or comment event is performed.

Webhook nameEnter a name for the webhook connection.
AccountEstablish a connection to your Todoist account.
GroupUse the drop-down menu to select whether you want to monitor changes in Tasks, Projects, or Comments.
Watch eventsSelect events performed in Todoist that will trigger this module.

Actions

Add a task

AccountEstablish a connection to your Todoist account.
ProjectSelect the project you want to create a task for.
LabelsSelect the label(s) you want to assign to the task.
Collaborator IDSelect the user you want to share the task with.
ContentEnter the content of the new task.
DateEnter a due date. For more information about supported formats refer to the Todoist Due Date and Time documentation.
PrioritySet 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
Establish a connection to your Todoist account.
LabelsSelect the label(s) you want to assign to the task.
Collaborator IDSelect the user you want to share the task with.
Task IDEnter (map) the ID of a task you want to update. You can use the Search for a Task module to retrieve the Task ID.
ContentEnter the updated content for the task.
DateEnter a due date. For more information about supported formats refer to the Todoist Due Date and Time documentation.
PrioritySet 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

AccountEstablish a connection to your Todoist account.
Task IDEnter (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.

AccountEstablish a connection to your Todoist account.
Task IDEnter (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.
AccountEstablish a connection to your Todoist account.
Task IDEnter (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

AccountEstablish a connection to your Todoist account.
Label IDEnter (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

AccountEstablish a connection to your Todoist account.
NameEnter a name for the new label.

Update a Label

Changes the label name.

AccountEstablish a connection to your Todoist account.
Label IDEnter (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.
NameEnter the new label name.

Delete a Label

AccountEstablish a connection to your Todoist account.
Label IDEnter (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.

AccountEstablish a connection to your Todoist account.
NameEnter a name for the new project.

Update a Project

Changes the name of the project.

AccountEstablish a connection to your Todoist account.
Project IDEnter (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.
NameEnter the new project name.

Delete a Project

Deletes a project.

AccountEstablish a connection to your Todoist account.
Project IDEnter (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.
AccountEstablish a connection to your Todoist account.
File nameSpecify the name of the file you want to upload. Don't forget the filename extension. E.g. integromat_logo.png
DataEnter (or map) a file data. More information about working with files.

Add a Comment to a Task

Creates a new comment for a task.

AccountEstablish a connection to your Todoist account.
Task IDEnter the ID of the task you want to comment on.
CommentEnter the desired comment.
Attachment file URLEnter 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

AccountEstablish a connection to your Todoist account.
Comment IDEnter (map) the ID of the comment you want to update. The ID can be retrieved, for example, using the Get Task Comments module.
CommentEnter the new content for the comment.

Delete a Comment

AccountEstablish a connection to your Todoist account.
Comment IDEnter (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.

AccountEstablish a connection to your Todoist account.
ProjectSelect the project you want to create a comment.
Comment
Enter the content of the new comment.
Attachment file URLEnter the URL of the file you want to attach with the comment.
Attachment file nameEnter or map the attachment file name with an extension.

Get Task Comments

Retrieves all comments for a selected task.

AccountEstablish a connection to your Todoist account.
Task IDEnter (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.

AccountEstablish a connection to your Todoist account.
Task IDEnter (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

AccountEstablish a connection to your Todoist account.
Project IDEnter (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.

AccountEstablish a connection to your Todoist account.
ProjectSelect the project that you want to search for a task.
Continue the execution of the scenario even if the module returns no tasksIf this option is enabled, the scenario flow will not get stopped by this module.
Maximum number of returned tasksEnter the maximum number of returned tasks that Integromat will work with during one cycle (the number of repetitions per scenario run).
PhraseEnter the keyword or sentence to search for the tasks that match the specified phrase.

Get Stats

Retrieves a productivity report.

AccountEstablish a connection to your Todoist account.

 

Popular use cases from our blog

automated-data-collection-crm-illustration

How to Automate Data Collection - Part 5: CRM Systems

automated-data-collection-chatbot-marketing-illustration

How to Automate Data Collection - Part 4: Chatbot Marketing

automated-data-collection-paid-ads-illustration

How to Automate Data Collection - Part 3: Paid Ads

automated-data-collection-email-illustration

How to Automate Data Collection - Part 2: Email Marketing Segmentation

personalized-customer-experience-illustration-integromat

5 Automated Solutions to Personalize Customer Experience

data-collection-automation-forms-pt-1

How to Automate Data Collection - Part 1: Online Forms

Didn’t find what you were looking for?

Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.