Todoist

Version Latest

Getting Started with Todoist

This is the documentation for the new Todoist app.
Here is the documentation for the legacy Todoist (legacy) app.

The Todoist modules allow you to monitor, create, update, list, and delete projects, labels, tasks, comments, and more in your Todoist account.

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.

Events

New Event

Triggers when a defined project, task, or comment action is performed.

Webhook name
Enter the name for the webhook. E.g. Task added.
AccountEstablish a connection to your Todoist account
GroupSelect whether you want to watch for task, project, or comment events.
Watch eventsSelect Todoist events that trigger the Integromat New Event module.

Projects

List Projects

Retrieves projects from your Todoist account.

ConnectionEstablish a connection to your Todoist account.
LimitSet the maximum number of projects Integromat will return during one execution cycle.

Get a Project

Retrieves project details.

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

Create a Project

Creates a new project.

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

2019-07-03_12_33_50-Integration_Todoist___Integromat.png

2019-07-03_12_34_35-Mozilla_Firefox.png

ConnectionEstablish a connection to your Todoist account.
NameEnter the name for the new project.
Parent projectSelect the parent project if you don't want to create a root project.

Update a Project

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

ConnectionEstablish a connection to your Todoist account.
Project IDEnter (map) the project ID of the project you want to delete.

Labels

List Labels

Retrieves labels from your Todoist account.

ConnectionEstablish a connection to your Todoist account.
LimitSet the maximum number of labels Integromat will return during one execution cycle.

Get a Label

Retrieves information about a label.

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

Create a Label

Creates a label.

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

Update a Label

Changes the name of the label.

ConnectionEstablish a connection to your Todoist account.
Label IDEnter (map) the label ID of the label you want to edit.
NameEnter a new name for the label.

Delete a Label

Deletes a label.

ConnectionEstablish a connection to your Todoist account.
Label IDEnter (map) the Label ID of the label you want to delete.

Tasks

List Uncompleted Tasks

Lists all uncompleted tasks.

ConnectionEstablish a connection to your Todoist account.
QueryEnter a keyword or phrase to list the tasks that match the specified tasks.
ProjectSelect or map the project whose incomplete tasks you want to list.
LimitSet the maximum number of tasks Integromat should return during one execution cycle.

Get a Task

Retrieves details about a specified task.

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

Create a Task

Creates a new task.

ConnectionEstablish a connection to your Todoist account.
ContentEnter the task content.
ProjectSelect the project or map the task ID. If not set, the task is put into the user’s Inbox.
LabelsSelect 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.

Human-readable representation of due date

What you type:

What Todoist understands:  

today

Today (tod also works)

tomorrow

Tomorrow (tom also works)

next week

The next Monday by default (this can be changed in your Settings)

next month

1st day of the next month

jan 27

Jan 27 (27 jan, 27/1 also works)

01/27/2016

January 27, 2016 (27/01/2016, 2016/01/27, 2016-01-27 also work)

27th

27th day of the current month

mid January

January 15th

end of month

Last day of the current month

today at 10

Today at 10am

tomorrow at 16:00

Tomorrow at 4pm

Fri @ 7pm

Friday at 7pm (Friday @ 7pm, Fri at 7pm, Fri at 19:00 also work)

6pm

Today at 6pm (unless 6pm has passed, in which case tomorrow) 

in 5 days

5 days from today (+5 days also works)

in 3 weeks

3 weeks from today

in 2 hours

2 hours from now

Is recurring
Select whether the task should be set as recurring.

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 bySelect the user who has assigned this task.
This works for shared projects only.
Auto reminderWhen 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.

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

ConnectionEstablish a connection to your Todoist account.
Task IDEnter (map) the Task ID of the task you want to delete.

Complete a Task

Completes a task and all its descendants.

ConnectionEstablish a connection to your Todoist account.
Task IDEnter (map) the Task ID of the task you want to set as complete.
Date completedEnter the date of completion of the task (in UTC). If left empty, the server will set the value to the current time. The list of supported date and time formats.

Uncomplete a Task

Uncompletes an unarchived task and all its ancestors.

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

Move a Task

Move a task to a different location.

ConnectionEstablish a connection to your Todoist account.
Task IDEnter (map) the Task ID of the task you want to move.
ProjectEnter (map) the target location.
Parent IDEnter the ID of the destination parent task.

Comments

List Project Comments

Returns all project comments.

ConnectionEstablish a connection to your Todoist account.
ProjectSelect the project you want to list comments from.
LimitSet the maximum number of comments Integromat will return during one execution cycle.

List Task Comments

Returns all of the comments for a task.

ConnectionEstablish a connection to your Todoist account.
TaskSelect the task you want to list comments from.
LimitSet the maximum number of tasks Integromat will return during one execution cycle.

Get a Project Comment

Retrieves the details of a project comment.

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

Get a Task Comment

Retrieves the details of a task comment.

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

Create a Task Comment

Adds a comment to a task.

ConnectionEstablish a connection to your Todoist account.
Task ID
Enter (map) the ID of the task you want to add the comment to.
ContentEnter 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.

Create a Project Comment

Adds a comment to the project.

ConnectionEstablish a connection to your Todoist account.
Project
Select the project you want to add a comment to.
ContentEnter the text content of 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.

Update a Comment

Changes the content of the comment.

ConnectionEstablish a connection to your Todoist account.
Comment IDEnter (map) the ID of the comment you want to update.
ContentEnter 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.

ConnectionEstablish a connection to your Todoist account.
Comment IDEnter (map) the ID of the comment you want to delete.

Other

Upload a File

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

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

9ZfeOxHg9v.gif

Get Stats

Retrieves productivity stats.

ConnectionEstablish a connection to your Todoist account.

Make an API Call

Allows you to perform a custom API call.

ConnectionEstablish 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.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter 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:

mceclip0.png

Matches of the search can be found in the module's Output under Bundle > Body
In our example, 3 active tasks were returned:

2019-10-17_10_57_19-Integration_Todoist___Integromat.png


Popular use cases from our blog

procur

How to Automate Procurement in Your Shopify Store - Part 1

Using Notion as CMS for Webflow -Tutorial- -illustration.png

How to Use Notion as a CMS for Your Webflow Site [Tutorial]

Basic-tutorial-for-Revolut-users-illustration.png

How to Create Your First Revolut Business Automation [Tutorial]

cancelled saas subscriptions-ILLUSTRATION.png

How to Track SaaS Subscriptions to Reduce Churn [Tutorial]

jira-excel-automation.png

How to Export From Jira to Excel Using Integromat [Tutorial]

influencer partner code sign up tracking-Illustration.png

How to Track Influencer Campaigns With Integromat

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
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.