Todoist

Is this page helpful?

Any additional feedback?

Feedback will be sent to Microsoft: By pressing the submit button, your feedback will be used to improve Microsoft products and services. Privacy policy.

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

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.

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)	Create a new label.
Create a label (V3) (Preview)	Create a new label.
Create a label [DEPRECATED]	This action has been deprecated. Please use Create a label (V3) instead. Create a new label (premium users only).
Create a project (V2)	Create a new project.
Create a project (V3) (Preview)	Create a new project.
Create a project [DEPRECATED]	This action has been deprecated. Please use Create a project (V3) instead. Create a new project.
Create a task (V2)	Create a new task in the specified project.
Create a task (V3) (Preview)	Create a new task in the specified project.
Create a task [DEPRECATED]	This action has been deprecated. Please use Create a task (V3) instead. Create a new task in the specified project.
List labels (V2)	List the labels configured in the Todoist account.
List labels (V3) (Preview)	List the labels configured in the Todoist account.
List labels [DEPRECATED]	This action has been deprecated. Please use List labels (V3) instead. List the labels configured in the Todoist account.
List projects (V2)	List all projects in the Todoist account.
List projects (V3) (Preview)	List all projects in the Todoist account.
List projects [DEPRECATED]	This action has been deprecated. Please use List projects (V3) instead. List all projects in the Todoist account.
List tasks (V2)	List all tasks in the Todoist account.
List tasks (V3) (Preview)	List all tasks in the Todoist account.
List tasks [DEPRECATED]	This action has been deprecated. Please use List tasks (V3) instead. List all tasks in the Todoist account.
List tasks by project (V2)	List all tasks in a specific project.
List tasks by project (V3) (Preview)	List all tasks in a specific project.
List tasks by project [DEPRECATED]	This action has been deprecated. Please use List tasks by project (V3) 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 (V3) (Preview)	Update an existing label.
Update a label [DEPRECATED]	This action has been deprecated. Please use Update a label (V3) instead. Update an existing label.
Update a project (V2)	Update an existing project.
Update a project (V3) (Preview)	Update an existing project.
Update a project [DEPRECATED]	This action has been deprecated. Please use Update a project (V3) instead. Update an existing project.
Update a task (V2)	Update an existing task.
Update a task (V3) (Preview)	Update an existing task.
Update a task [DEPRECATED]	This action has been deprecated. Please use Update a task (V3) instead. Update an existing task.

Create a label (V2)

Operation ID:

CreateLabelV2

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) (Preview)

Operation ID:

CreateLabelV3

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]

Operation ID:

CreateLabel

This action has been deprecated. Please use Create a label (V3) 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)

Operation ID:

CreateProjectV2

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) (Preview)

Operation ID:

CreateProjectV3

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]

Operation ID:

CreateProject

This action has been deprecated. Please use Create a project (V3) 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)

Operation ID:

CreateItemV2

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) (Preview)

Operation ID:

CreateItemV3

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]

Operation ID:

CreateItem

This action has been deprecated. Please use Create a task (V3) 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)

Operation ID:

ListLabelsV2

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) (Preview)

Operation ID:

ListLabelsV3

List the labels configured in the Todoist account.

Returns

response

array of LabelV3

List labels [DEPRECATED]

Operation ID:

ListLabels

This action has been deprecated. Please use List labels (V3) 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)

Operation ID:

ListProjectsV2

List all projects in the Todoist account.

Returns

Name	Path	Type	Description
Projects	projects	array of Project	A collection of projects

List projects (V3) (Preview)

Operation ID:

ListProjectsV3

List all projects in the Todoist account.

Returns

response

array of ProjectV3

List projects [DEPRECATED]

Operation ID:

ListProjects

This action has been deprecated. Please use List projects (V3) 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)

Operation ID:

ListItemsV2

List all tasks in the Todoist account.

Returns

Name	Path	Type	Description
Items	items	array of ItemV2	A collection of items

List tasks (V3) (Preview)

Operation ID:

ListItemsV3

List all tasks in the Todoist account.

Returns

response

array of Task

List tasks [DEPRECATED]

Operation ID:

ListItems

This action has been deprecated. Please use List tasks (V3) 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)

Operation ID:

ListItemsByProjectV2

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) (Preview)

Operation ID:

ListItemsByProjectV3

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]

Operation ID:

ListItemsByProject

This action has been deprecated. Please use List tasks by project (V3) 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)

Operation ID:

ShareProjectV2

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]

Operation ID:

ShareProject

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)

Operation ID:

UpdateLabelV2

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) (Preview)

Operation ID:

UpdateLabelV3

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]

Operation ID:

UpdateLabel

This action has been deprecated. Please use Update a label (V3) 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)

Operation ID:

UpdateProjectV2

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) (Preview)

Operation ID:

UpdateProjectV3

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]

Operation ID:

UpdateProject

This action has been deprecated. Please use Update a project (V3) 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)

Operation ID:

UpdateItemV2

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) (Preview)

Operation ID:

UpdateItemV3

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]

Operation ID:

UpdateItem

This action has been deprecated. Please use Update a task (V3) 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)

Operation ID:

OnItemCompletedV2

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]

Operation ID:

OnItemCompleted

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)

Operation ID:

OnItemCreatedV2

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]

Operation ID:

OnItemCreated

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.

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