Todoist

Todoist

Todoist is an online task management app and todo list. With Todoist, users can organize, schedule, maintain and prioritize personal tasks.

To use this integration, you will need access to a Todoist account. To make a connection, select Sign In. You will be prompted to provide your Todoist login, follow the remainder of the screens to create a connection. Note some of the operations in the connector may require a Todoist Premium account, if you see a failure in one of your operations please review the message and confirm your account type.

You're now ready to start using this integration.

Throttling Limits

Name Calls Renewal Period
API calls per connection 30 60 seconds
Frequency of trigger polls 1 15 seconds

Actions

Create a label

Create a new label (premium users only).

Required Parameters

Name
string
The name of the label.

Optional Parameters

Color
string
The color of the label (a number between 0 and 7, or 0 and 12 for premium users).
Order
string
The label's order in the label list (a number, where the smallest value is top-level).

Returns

Body
Label

A Todoist Label Object

Create a project

Create a new project.

Required Parameters

Name
string
The name of the project.

Optional Parameters

Color
string
A number between 0 and 11, or 0 and 21 for premium users.
Indent
string
A number between 1 and 4, where 1 is top-level).
Order
string
A number, where the smallest value is top-level.

Returns

Body
Project

A Todoist Project Object

Create a task

Create a new task in the specified project.

Required Parameters

Project Id
string
The unique identifier of the project.
Title
string
The title of the task.

Optional Parameters

Due Date
date-time
The task due date (e.g mm-dd-yyyy, Today @ 11am, mm/dd/yyyy).
Priority
string
A number between 1 and 4 (4 for very urgent and 1 for natural).
Indent
string
A number between 1 and 4, where 1 is top-level).
Order
string
A number, where the smallest value is top-level.

Returns

Body
Item

A Todoist Item Object

List labels

List the labels configured in the Todoist account.

Required Parameters

Name
string
The name of the label.

Optional Parameters

Color
string
The color of the label (a number between 0 and 7, or 0 and 12 for premium users).
Order
string
The label's order in the label list (a number, where the smallest value is top-level).

Returns

Labels
array of Label
A collection of labels

List projects

List all projects in the Todoist account.

Required Parameters

Name
string
The name of the label.

Optional Parameters

Color
string
The color of the label (a number between 0 and 7, or 0 and 12 for premium users).
Order
string
The label's order in the label list (a number, where the smallest value is top-level).

Returns

Projects
array of Project
A collection of projects

List tasks

List all tasks in the Todoist account.

Required Parameters

Name
string
The name of the label.

Optional Parameters

Color
string
The color of the label (a number between 0 and 7, or 0 and 12 for premium users).
Order
string
The label's order in the label list (a number, where the smallest value is top-level).

Returns

Items
array of Item
A collection of items

List tasks by project

List all tasks in a specific project.

Required Parameters

Project Id
string
The unique identifier of the project.

Returns

Items
array of Item
A collection of items

Share a project

Share an existing project to a specific user.

Required Parameters

Project Id
string
The unique identifier of the project.
Email
string
The email address of user the project is being shared to.

Returns

Body
Project

A Todoist Project Object

Update a label

Update an existing label.

Required Parameters

Label Id
string
The unique identifier of the label.

Optional Parameters

Name
string
The name of the label.
Color
string
The color of the label (a number between 0 and 7, or 0 and 12 for premium users).
Order
string
The label's order in the label list (a number, where the smallest value is top-level).

Returns

Body
Label

A Todoist Label Object

Update a project

Update an existing project.

Required Parameters

Project Id
string
The unique identifier of the project.

Optional Parameters

Name
string
The name of the project.
Color
string
A number between 0 and 11, or 0 and 21 for premium users.
Indent
string
A number between 1 and 4, where 1 is top-level).
Order
string
A number, where the smallest value is top-level.

Returns

Body
Project

A Todoist Project Object

Update a task

Update an existing task.

Required Parameters

Project Id
string
The unique identifier of the project.
Task Id
string
The unique identifier of the task.

Optional Parameters

Title
string
The title of the task.
Priority
string
A number between 1 and 4, 4 for very urgent and 1 for natural.
Indent
string
A number between 1 and 4, where 1 is top-level).
Order
string
A number, where the smallest value is top-level.

Returns

Body
Item

A Todoist Item Object

Triggers

When a task is completed

Triggers a new flow when a task is completed.

Required Parameters

Project Id
string
The unique identifier of the project.

Returns

Items
array of Item
A collection of items

When a task is created

Trigers a new flow when a task is created.

Required Parameters

Project Id
string
The unique identifier of the project.

Returns

Items
array of Item
A collection of items

Definitions

Project

A Todoist Project Object

Color
integer
The color of the project.
Is Project Archived
integer
A number value (1 is true, 0 is false) indicating whether or not the project is deleted.
Is Project Deleted
integer
A number value (1 is true, 0 is false) indicating whether or not the project is deleted.
Is Project Shared
boolean
Is Project Shared
Project Id
string
The unique identifier of the project.
Project Name
string
The name of the project.

Item

A Todoist Item Object

Assignee Id
integer
The id of user who is responsible for accomplishing the current task. For shared projects only.
Assigner Id
integer
The id of the user who assigns the current task. For shared projects only.
Date Created
date-time
The date when the task was created.
Date Language
string
The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).
Indent
integer
The indent of the task (a number between 1 and 4, where 1 is top-level).
IsTaskArchived
integer
Whether the task is marked as archived (where 1 is true and 0 is false).
IsTaskCompleted
integer
Whether the task is marked as completed (where 1 is true and 0 is false).
Order
integer
The order of the task inside a project (the smallest value would place the task at the top).
Project Id
string
The project where task resides.
Task Due Date
date-time
The date of the task in the format Mon 07 Aug 2006 12:34:56 +0000.
Task Id
string
The id of the task.
Task Owner
integer
The owner of the task.
Task Priority
integer
The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).
Task Title
string
The title of the task.

Label

A Todoist Label Object

Color
integer
The color of the label (a number between 0 and 7, or between 0 and 12 for premium users).
IsDeleted
integer
Whether the label is marked as deleted (where 1 is true and 0 is false).
Label Id
integer
The id of the label.
Label Name
string
The name of the label.
Order
integer
Label’s order in the label list (a number, where the smallest value is top-level).