Todoist

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
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

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 connection3060 seconds
Frequency of trigger polls115 seconds

Actions

Create a label (V2)

Create a new label.

Create a label [DEPRECATED]

This action has been deprecated. Please use Create a label (V2) instead.

Create a new label (premium users only).

Create a project (V2)

Create a new project.

Create a project [DEPRECATED]

This action has been deprecated. Please use Create a project (V2) instead.

Create a new project.

Create a task (V2)

Create a new task in the specified project.

Create a task [DEPRECATED]

This action has been deprecated. Please use Create a task (V2) instead.

Create a new task in the specified project.

List labels (V2)

List the labels configured in the Todoist account.

List labels [DEPRECATED]

This action has been deprecated. Please use List labels (V2) instead.

List the labels configured in the Todoist account.

List projects (V2)

List all projects in the Todoist account.

List projects [DEPRECATED]

This action has been deprecated. Please use List projects (V2) instead.

List all projects in the Todoist account.

List tasks (V2)

List all tasks in the Todoist account.

List tasks [DEPRECATED]

This action has been deprecated. Please use List tasks (V2) instead.

List all tasks in the Todoist account.

List tasks by project (V2)

List all tasks in a specific project.

List tasks by project [DEPRECATED]

This action has been deprecated. Please use List tasks by project (V2) instead.

List all tasks in a specific project.

Share a project (V2)

Share an existing project to a specific user.

Share a project [DEPRECATED]

This action has been deprecated. Please use Share a project (V2) instead.

Share an existing project to a specific user.

Update a label (V2)

Update an existing label.

Update a label [DEPRECATED]

This action has been deprecated. Please use Update a label (V2) instead.

Update an existing label.

Update a project (V2)

Update an existing project.

Update a project [DEPRECATED]

This action has been deprecated. Please use Update a project (V2) instead.

Update an existing project.

Update a task (V2)

Update an existing task.

Update a task [DEPRECATED]

This action has been deprecated. Please use Update a task (V2) instead.

Update an existing task.

Create a label (V2)

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 [DEPRECATED]

This action has been deprecated. Please use Create a label (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use Create a project (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use Create a task (V2) instead.

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)

List the labels configured in the Todoist account.

Returns

Name Path Type Description
Labels
labels array of LabelV2

A collection of labels

List labels [DEPRECATED]

This action has been deprecated. Please use List labels (V2) instead.

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)

List all projects in the Todoist account.

Returns

Name Path Type Description
Projects
projects array of Project

A collection of projects

List projects [DEPRECATED]

This action has been deprecated. Please use List projects (V2) instead.

List all projects in the Todoist account.

Returns

Name Path Type Description
Projects
projects array of Project

A collection of projects

List tasks (V2)

List all tasks in the Todoist account.

Returns

Name Path Type Description
Items
items array of ItemV2

A collection of items

List tasks [DEPRECATED]

This action has been deprecated. Please use List tasks (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use List tasks by project (V2) instead.

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)

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]

This action has been deprecated. Please use Share a project (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use Update a label (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use Update a project (V2) instead.

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)

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 [DEPRECATED]

This action has been deprecated. Please use Update a task (V2) instead.

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)

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

When a task is completed [DEPRECATED]

This action has been deprecated. Please use When a task is completed (V2) instead.

Triggers a new flow when a task is completed.

When a task is created (V2)

Trigers a new flow when a task is created.

When a task is created [DEPRECATED]

This action has been deprecated. Please use When a task is created (V2) instead.

Trigers a new flow when a task is created.

When a task is completed (V2)

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]

This action has been deprecated. Please use When a task is completed (V2) instead.

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)

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]

This action has been deprecated. Please use When a task is created (V2) instead.

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.

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.

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