Todoist [DEPRECATED]

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

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://todoist.com/
Privacy policy https://todoist.com/privacy

Important

All actions and triggers of the connector cannot be used at this moment due to the Todoist's depreciation of REST API (v1). In order to switch to the new version, please vote for it here.

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.

Note

In order to view the current status of the Todoist API backend service, active incidents, or upcoming maintenance, go to Todoist Status page.

You're now ready to start using this integration.

Known issues and limitations

1. Connections

Due to limitations in Todoist OAuth process:

  1. Currently logged Todoist account will be automatically picked to use while creating connection.
  2. Switching between accounts for an existing connection is not supported in the standard way, and thus if you need to switch to another Todoist account please log out of the Todoist portal beforehand or use browser incognito mode.

Throttling Limits

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

Actions

Create a label (V2) [DEPRECATED]

Create a new label.

Create a label (V3) [DEPRECATED]

Create a new label.

Create a label [DEPRECATED]

Create a new label (premium users only).

Create a project (V2) [DEPRECATED]

Create a new project.

Create a project (V3) [DEPRECATED]

Create a new project.

Create a project [DEPRECATED]

Create a new project.

Create a task (V2) [DEPRECATED]

Create a new task in the specified project.

Create a task (V3) [DEPRECATED]

Create a new task in the specified project.

Create a task [DEPRECATED]

Create a new task in the specified project.

List labels (V2) [DEPRECATED]

List the labels configured in the Todoist account.

List labels (V3) [DEPRECATED]

List the labels configured in the Todoist account.

List labels [DEPRECATED]

List the labels configured in the Todoist account.

List projects (V2) [DEPRECATED]

List all projects in the Todoist account.

List projects (V3) [DEPRECATED]

List all projects in the Todoist account.

List projects [DEPRECATED]

List all projects in the Todoist account.

List tasks (V2) [DEPRECATED]

List all tasks in the Todoist account.

List tasks (V3) [DEPRECATED]

List all tasks in the Todoist account.

List tasks [DEPRECATED]

List all tasks in the Todoist account.

List tasks by project (V2) [DEPRECATED]

List all tasks in a specific project.

List tasks by project (V3) [DEPRECATED]

List all tasks in a specific project.

List tasks by project [DEPRECATED]

List all tasks in a specific project.

Share a project (V2) [DEPRECATED]

Share an existing project to a specific user.

Share a project [DEPRECATED]

Share an existing project to a specific user.

Update a label (V2) [DEPRECATED]

Update an existing label.

Update a label (V3) [DEPRECATED]

Update an existing label.

Update a label [DEPRECATED]

Update an existing label.

Update a project (V2) [DEPRECATED]

Update an existing project.

Update a project (V3) [DEPRECATED]

Update an existing project.

Update a project [DEPRECATED]

Update an existing project.

Update a task (V2) [DEPRECATED]

Update an existing task.

Update a task (V3) [DEPRECATED]

Update an existing task.

Update a task [DEPRECATED]

Update an existing task.

Create a label (V2) [DEPRECATED]

Create a new label.

Parameters

Name Key Required Type Description
Name
name True string

The name of the label.

Color
color string

Color id. It’s a value between 30 and 49.

Order
item_order string

Label’s order in the label list (a number, where the smallest value should place the label at the top).

Returns

A Todoist Label Object

Body
LabelV2

Create a label (V3) [DEPRECATED]

Create a new label.

Parameters

Name Key Required Type Description
Name
name True string

The name of the label.

Color
color integer

Color id. It’s a value between 30 and 49.

Order
order integer

Label’s order in the label list (a number, where the smallest value should place the label at the top).

Returns

A Todoist Label Object

Body
LabelV3

Create a label [DEPRECATED]

Create a new label (premium users only).

Parameters

Name Key Required Type Description
Name
name True string

The name of the label.

Color
color string

The color of the label (a number between 0 and 7, or 0 and 12 for premium users).

Order
item_order string

The label's order in the label list (a number, where the smallest value is top-level).

Returns

A Todoist Label Object

Body
Label

Create a project (V2) [DEPRECATED]

Create a new project.

Parameters

Name Key Required Type Description
Name
name True string

The name of the project.

Color
color integer

Color id. It’s a value between 30 and 49.

Parent Id
parent_id string

The id of the parent project. Set to null for root projects

Child order
child_order integer

The order of project. Defines the position of the project among all the projects with the same Parent Id

Is favorite
is_favorite integer

Whether the project is favorite (where 1 is true and 0 is false).

Returns

A Todoist Project Object

Body
Project

Create a project (V3) [DEPRECATED]

Create a new project.

Parameters

Name Key Required Type Description
Name
name True string

The name of the project.

Color
color integer

Color id. It’s a value between 30 and 49.

Parent Id
parent_id integer

The id of the parent project. Set to null for root projects

Is favorite
favorite boolean

Whether the project is favorite (a true or false value).

Returns

A Todoist Project Object

Body
ProjectV3

Create a project [DEPRECATED]

Create a new project.

Parameters

Name Key Required Type Description
Name
name True string

The name of the project.

Color
color string

A number between 0 and 11, or 0 and 21 for premium users.

Indent
indent string

A number between 1 and 4, where 1 is top-level).

Order
item_order string

A number, where the smallest value is top-level.

Returns

A Todoist Project Object

Body
Project

Create a task (V2) [DEPRECATED]

Create a new task in the specified project.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Title
content True string

The title of the task.

Due Date
date_string date-time

The task due date (e.g 2017-07-21T17:32:28Z).

Priority
priority string

A number between 1 and 4 (4 for very urgent and 1 for natural).

Parent Id
parent_id string

The id of the parent task. Set to null for root tasks

Child order
child_order integer

The order of task. Defines the position of the task among all the tasks with the same Parent Id

Returns

A Todoist Item Object

Body
ItemV2

Create a task (V3) [DEPRECATED]

Create a new task in the specified project.

Parameters

Name Key Required Type Description
Title
content True string

The title of the task.

Project Id
project_id integer

Task project id. If not set, task is put to user’s Inbox.

Due Date
due_string date-time

The task due date (e.g 2017-07-21T17:32:28Z).

Priority
priority string

A number between 1 and 4 (4 for very urgent and 1 for natural).

Parent Id
parent_id integer

The id of the parent task. Set to null for root tasks

Child order
order integer

The order of task. Defines the position of the task among all the tasks with the same Parent Id

Returns

A Todoist Task Object

Body
Task

Create a task [DEPRECATED]

Create a new task in the specified project.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Title
content True string

The title of the task.

Due Date
date_string date-time

The task due date (e.g mm-dd-yyyy, Today @ 11am, mm/dd/yyyy).

Priority
priority string

A number between 1 and 4 (4 for very urgent and 1 for natural).

Indent
indent string

A number between 1 and 4, where 1 is top-level).

Order
item_order string

A number, where the smallest value is top-level.

Returns

A Todoist Item Object

Body
Item

List labels (V2) [DEPRECATED]

List the labels configured in the Todoist account.

Returns

Name Path Type Description
Labels
labels array of LabelV2

A collection of labels

List labels (V3) [DEPRECATED]

List the labels configured in the Todoist account.

Returns

response
array of LabelV3

List labels [DEPRECATED]

List the labels configured in the Todoist account.

Returns

Name Path Type Description
Labels
labels array of Label

A collection of labels

List projects (V2) [DEPRECATED]

List all projects in the Todoist account.

Returns

Name Path Type Description
Projects
projects array of Project

A collection of projects

List projects (V3) [DEPRECATED]

List all projects in the Todoist account.

Returns

List projects [DEPRECATED]

List all projects in the Todoist account.

Returns

Name Path Type Description
Projects
projects array of Project

A collection of projects

List tasks (V2) [DEPRECATED]

List all tasks in the Todoist account.

Returns

Name Path Type Description
Items
items array of ItemV2

A collection of items

List tasks (V3) [DEPRECATED]

List all tasks in the Todoist account.

Returns

response
array of Task

List tasks [DEPRECATED]

List all tasks in the Todoist account.

Returns

Name Path Type Description
Items
items array of Item

A collection of items

List tasks by project (V2) [DEPRECATED]

List all tasks in a specific project.

Parameters

Name Key Required Type Description
Project Id
id True string

The unique identifier of the project.

Returns

Name Path Type Description
Items
items array of ItemV2

A collection of items

List tasks by project (V3) [DEPRECATED]

List all tasks in a specific project.

Parameters

Name Key Required Type Description
Project Id
project_id True integer

The unique identifier of the project.

Returns

response
array of Task

List tasks by project [DEPRECATED]

List all tasks in a specific project.

Parameters

Name Key Required Type Description
Project Id
id True string

The unique identifier of the project.

Returns

Name Path Type Description
Items
items array of Item

A collection of items

Share a project (V2) [DEPRECATED]

Share an existing project to a specific user.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Email
email True string

The user email with whom to share the project.

Returns

A Todoist Project Object

Body
Project

Share a project [DEPRECATED]

Share an existing project to a specific user.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Email
email True string

The email address of user the project is being shared to.

Returns

A Todoist Project Object

Body
Project

Update a label (V2) [DEPRECATED]

Update an existing label.

Parameters

Name Key Required Type Description
Label Id
label_id True string

The unique identifier of the label.

Name
name string

The name of the label.

Color
color string

Color id. It’s a value between 30 and 49.

Order
item_order string

Label’s order in the label list.

Returns

A Todoist Label Object

Body
LabelV2

Update a label (V3) [DEPRECATED]

Update an existing label.

Parameters

Name Key Required Type Description
Label Id
id True string

The unique identifier of the label.

Name
name string

The name of the label.

Color
color integer

Color id. It’s a value between 30 and 49.

Order
order integer

Label’s order in the label list.

Update a label [DEPRECATED]

Update an existing label.

Parameters

Name Key Required Type Description
Label Id
label_id True string

The unique identifier of the label.

Name
name string

The name of the label.

Color
color string

The color of the label (a number between 0 and 7, or 0 and 12 for premium users).

Order
item_order string

The label's order in the label list (a number, where the smallest value is top-level).

Returns

A Todoist Label Object

Body
Label

Update a project (V2) [DEPRECATED]

Update an existing project.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Name
name True string

The name of the project.

Color
color string

Color id. It’s a value between 30 and 49.

Is favorite
is_favorite integer

Whether the project is favorite (where 1 is true and 0 is false).

Returns

A Todoist Project Object

Body
Project

Update a project (V3) [DEPRECATED]

Update an existing project.

Parameters

Name Key Required Type Description
Project Id
id True integer

The unique identifier of the project.

Name
name True string

The name of the project.

Color
color string

Color id. It’s a value between 30 and 49.

Is favorite
favorite boolean

Whether the project is favorite (a true or false value).

Update a project [DEPRECATED]

Update an existing project.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Name
name string

The name of the project.

Color
color string

A number between 0 and 11, or 0 and 21 for premium users.

Indent
indent string

A number between 1 and 4, where 1 is top-level).

Order
item_order string

A number, where the smallest value is top-level.

Returns

A Todoist Project Object

Body
Project

Update a task (V2) [DEPRECATED]

Update an existing task.

Parameters

Name Key Required Type Description
Project Id
id True string

The unique identifier of the project.

Task Id
item_id True string

The unique identifier of the task.

Title
content True string

The title of the task.

Priority
priority string

A number between 1 and 4, 4 for very urgent and 1 for natural.

Returns

A Todoist Item Object

Body
ItemV2

Update a task (V3) [DEPRECATED]

Update an existing task.

Parameters

Name Key Required Type Description
Project Id
project_id True integer

The unique identifier of the project.

Task Id
id True string

The unique identifier of the task.

Title
content True string

The title of the task.

Priority
priority string

A number between 1 and 4, 4 for very urgent and 1 for natural.

Update a task [DEPRECATED]

Update an existing task.

Parameters

Name Key Required Type Description
Project Id
id True string

The unique identifier of the project.

Task Id
item_id True string

The unique identifier of the task.

Title
content string

The title of the task.

Priority
priority string

A number between 1 and 4, 4 for very urgent and 1 for natural.

Indent
indent string

A number between 1 and 4, where 1 is top-level).

Order
item_order string

A number, where the smallest value is top-level.

Returns

A Todoist Item Object

Body
Item

Triggers

When a task is completed (V2) [DEPRECATED]

Triggers a new flow when a task is completed (premium users only).

When a task is completed [DEPRECATED]

Triggers a new flow when a task is completed.

When a task is created (V2) [DEPRECATED]

Trigers a new flow when a task is created.

When a task is created [DEPRECATED]

Trigers a new flow when a task is created.

When a task is completed (V2) [DEPRECATED]

Triggers a new flow when a task is completed (premium users only).

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Returns

Name Path Type Description
Completed Items
items array of CompletedItem

A collection of completed items

When a task is completed [DEPRECATED]

Triggers a new flow when a task is completed.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Returns

Name Path Type Description
Items
items array of Item

A collection of items

When a task is created (V2) [DEPRECATED]

Trigers a new flow when a task is created.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Returns

Name Path Type Description
Items
items array of ItemV2

A collection of items

When a task is created [DEPRECATED]

Trigers a new flow when a task is created.

Parameters

Name Key Required Type Description
Project Id
project_id True string

The unique identifier of the project.

Returns

Name Path Type Description
Items
items array of Item

A collection of items

Definitions

Project

A Todoist Project Object

Name Path Type Description
Project Id
id string

The unique identifier of the project.

Project Name
name string

The name of the project.

Color
color integer

The color of the project.

Is Project Shared
shared boolean

Is Project Shared

Is Project Deleted
is_deleted integer

A number value (1 is true, 0 is false) indicating whether or not the project is deleted.

Is Project Archived
is_archived integer

A number value (1 is true, 0 is false) indicating whether or not the project is archived.

ProjectV3

A Todoist Project Object

Name Path Type Description
Project Id
id integer

The unique identifier of the project.

Project Name
name string

The name of the project.

Comment Count
comment_count integer

The number of comments.

Order
order integer

The order of the project under the same parent.

Color
color integer

The color of the project.

Is Project Shared
shared boolean

Is Project Shared

Sync Id
sync_id integer

Identifier to find the match between different copies of shared projects.

Is Project Favorite
favorite boolean

Is Project Favorite

Is Project Shared
inbox_project boolean

Is Project Inbox

Item

A Todoist Item Object

Name Path Type Description
Task Title
content string

The title of the task.

Task Id
id string

The id of the task.

Task Owner
user_id integer

The owner of the task.

Project Id
project_id string

The project where task resides.

Date Language
date_lang string

The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).

Task Due Date
due_date_utc date-time

The date of the task in the format Mon 07 Aug 2006 12:34:56 +0000.

Indent
indent integer

The indent of the task (a number between 1 and 4, where 1 is top-level).

Task Priority
priority integer

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

Order
item_order integer

The order of the task inside a project (the smallest value would place the task at the top).

Assigner Id
assigned_by_uid integer

The id of the user who assigns the current task. For shared projects only.

Assignee Id
responsible_uid integer

The id of user who is responsible for accomplishing the current task. For shared projects only.

IsTaskCompleted
checked integer

Whether the task is marked as completed (where 1 is true and 0 is false).

IsTaskArchived
is_archived integer

Whether the task is marked as archived (where 1 is true and 0 is false).

Date Created
date_added date-time

The date when the task was created.

ItemV2

A Todoist Item Object

Name Path Type Description
Task Title
content string

The title of the task.

Task Id
id string

The id of the task.

Task Owner
user_id integer

The owner of the task.

Project Id
project_id string

The project where task resides.

Date Language
date_lang string

The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).

Task Due Date
due_date_utc date-time

The date of the task in the format 2006-08-07T16:34:56Z.

Parent Id
parent_id integer

The id of the parent task. Set to null for root tasks

Child order
child_order integer

The order of task. Defines the position of the task among all the tasks with the same parent_id

Task Priority
priority integer

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

Assigner Id
assigned_by_uid integer

The id of the user who assigns the current task. For shared projects only.

Assignee Id
responsible_uid integer

The id of user who is responsible for accomplishing the current task. For shared projects only.

IsTaskCompleted
checked integer

Whether the task is marked as completed (where 1 is true and 0 is false).

Date Created
date_added date-time

The date when the task was created.

Task

A Todoist Task Object

Name Path Type Description
Task Id
id integer

The id of the task.

Is Task Completed
completed boolean

Is task completed

Project Id
project_id integer

The project where task resides.

Section Id
section_id integer

Id of section task belongs to.

Parent Id
parent_id integer

The id of the parent task. Set to null for root tasks.

Task content
content string

Task content.

Comment count
comment_count integer

Number of task comments

Order
order integer

The order of task. Defines the position of the task among all the tasks with the same parent_id

Task Priority
priority integer

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

Task URL
url string

URL to access this task in Todoist web interface.

CompletedItem

A Todoist completed task Object

Name Path Type Description
Task Entry Id
id string

The id of the completed task entry.

Task Id
task_id integer

The id of the completed task.

Task Owner
user_id integer

The owner of the task.

Project Id
project_id string

The project where task resides.

Task Title
content string

The title of the task.

Date Completed
completed_date date-time

The date when the task was completed.

Notes Count
note_count integer

The number of notes of the task.

Details
meta_data string

Optional extra details.

Label

A Todoist Label Object

Name Path Type Description
Label Id
id integer

The id of the label.

Label Name
name string

The name of the label.

Color
color integer

The color of the label (a number between 0 and 7, or between 0 and 12 for premium users).

Order
item_order integer

Label’s order in the label list (a number, where the smallest value is top-level).

IsDeleted
is_deleted integer

Whether the label is marked as deleted (where 1 is true and 0 is false).

LabelV2

A Todoist Label Object

Name Path Type Description
Label Id
id integer

The id of the label.

Label Name
name string

The name of the label.

Color
color integer

Color id. It’s a value between 30 and 49, more info - https://developer.todoist.com/sync/v8/#colors

Order
item_order integer

Label’s order in the label list (a number, where the smallest value should place the label at the top).

IsDeleted
is_deleted integer

Whether the label is marked as deleted (where 1 is true and 0 is false).

IsFavorite
is_favorite integer

Whether the label is favorite (where 1 is true and 0 is false).

LabelV3

A Todoist Label Object

Name Path Type Description
Label Id
id integer

The id of the label.

Label Name
name string

The name of the label.

Color
color integer

Color id. It’s a value between 30 and 49, more info - https://developer.todoist.com/sync/v8/#colors

Order
order integer

Label’s order in the label list (a number, where the smallest value should place the label at the top).

IsFavorite
favorite boolean

Whether the label is favorite (a true or false value).