Todoist

Reference

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:

Currently logged Todoist account will be automatically picked to use while creating connection.
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]	This action has been deprecated. Please use Create a label (V4) instead. ~~Create a new label.~~
Create a label (V3) [DEPRECATED]	This action has been deprecated. Please use Create a label (V4) instead. ~~Create a new label.~~
Create a label (V4)	Create a new label.
Create a label [DEPRECATED]	This action has been deprecated. Please use Create a label (V4) instead. ~~Create a new label (premium users only).~~
Create a project (V2) [DEPRECATED]	This action has been deprecated. Please use Create a project (V4) instead. ~~Create a new project.~~
Create a project (V3) [DEPRECATED]	This action has been deprecated. Please use Create a project (V4) instead. ~~Create a new project.~~
Create a project (V4)	Create a new project.
Create a project [DEPRECATED]	This action has been deprecated. Please use Create a project (V4) instead. ~~Create a new project.~~
Create a task (V2) [DEPRECATED]	This action has been deprecated. Please use Create a task (V4) instead. ~~Create a new task in the specified project.~~
Create a task (V3) [DEPRECATED]	This action has been deprecated. Please use Create a task (V4) instead. ~~Create a new task in the specified project.~~
Create a task (V4)	Create a new task in the specified project.
Create a task [DEPRECATED]	This action has been deprecated. Please use Create a task (V4) instead. ~~Create a new task in the specified project.~~
List labels (V2) [DEPRECATED]	This action has been deprecated. Please use List labels (V4) instead. ~~List the labels configured in the Todoist account.~~
List labels (V3) [DEPRECATED]	This action has been deprecated. Please use List labels (V4) instead. ~~List the labels configured in the Todoist account.~~
List labels (V4)	List the labels configured in the Todoist account.
List labels [DEPRECATED]	This action has been deprecated. Please use List labels (V4) instead. ~~List the labels configured in the Todoist account.~~
List projects (V2) [DEPRECATED]	This action has been deprecated. Please use List projects (V4) instead. ~~List all projects in the Todoist account.~~
List projects (V3) [DEPRECATED]	This action has been deprecated. Please use List projects (V4) instead. ~~List all projects in the Todoist account.~~
List projects (V4)	List all projects in the Todoist accounts.
List projects [DEPRECATED]	This action has been deprecated. Please use List projects (V4) instead. ~~List all projects in the Todoist account.~~
List tasks (V2) [DEPRECATED]	This action has been deprecated. Please use List tasks (V4) instead. ~~List all tasks in the Todoist account.~~
List tasks (V3) [DEPRECATED]	This action has been deprecated. Please use List tasks (V4) instead. ~~List all tasks in the Todoist account.~~
List tasks (V4)	List all tasks in the Todoist account.
List tasks [DEPRECATED]	This action has been deprecated. Please use List tasks (V4) instead. ~~List all tasks in the Todoist account.~~
List tasks by project (V2) [DEPRECATED]	This action has been deprecated. Please use List tasks by project (V4) instead. ~~List all tasks in a specific project.~~
List tasks by project (V3) [DEPRECATED]	This action has been deprecated. Please use List tasks by project (V4) instead. ~~List all tasks in a specific project.~~
List tasks by project (V4)	List all tasks in a specific project.
List tasks by project [DEPRECATED]	This action has been deprecated. Please use List tasks by project (V4) instead. ~~List all tasks in a specific project.~~
Share a project (V2) [DEPRECATED]	This action has been deprecated. Please use Share a project (V4) instead. ~~Share an existing project to a specific user.~~
Share a project (V4)	Share an existing project to a specific user.
Share a project [DEPRECATED]	This action has been deprecated. Please use Share a project (V4) instead. ~~Share an existing project to a specific user.~~
Update a label (V2) [DEPRECATED]	This action has been deprecated. Please use Update a label (V4) instead. ~~Update an existing label.~~
Update a label (V3) [DEPRECATED]	This action has been deprecated. Please use Update a label (V4) instead. ~~Update an existing label.~~
Update a label (V4)	Update an existing label.
Update a label [DEPRECATED]	This action has been deprecated. Please use Update a label (V4) instead. ~~Update an existing label.~~
Update a project (V2) [DEPRECATED]	This action has been deprecated. Please use Update a project (V4) instead. ~~Update an existing project.~~
Update a project (V3) [DEPRECATED]	This action has been deprecated. Please use Update a project (V4) instead. ~~Update an existing project.~~
Update a project (V4)	Update an existing project.
Update a project [DEPRECATED]	This action has been deprecated. Please use Update a project (V4) instead. ~~Update an existing project.~~
Update a task (V2) [DEPRECATED]	This action has been deprecated. Please use Update a task (V4) instead. ~~Update an existing task.~~
Update a task (V3) [DEPRECATED]	This action has been deprecated. Please use Update a task (V4) instead. ~~Update an existing task.~~
Update a task (V4)	Update an existing task.
Update a task [DEPRECATED]	This action has been deprecated. Please use Update a task (V4) instead. ~~Update an existing task.~~

Create a label (V2) [DEPRECATED]

Operation ID:: CreateLabelV2

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

~~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]

Operation ID:: CreateLabelV3

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

~~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 (V4)

Operation ID:: CreateLabelV4

Create a new label.

Parameters

Name	Key	Required	Type	Description
Name	name	True	string	The name of the label.
Color	color		string	The color of the project icon.
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: LabelV4

Create a label [DEPRECATED]

Operation ID:: CreateLabel

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

Operation ID:: CreateProjectV2

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

~~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]

Operation ID:: CreateProjectV3

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

~~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 (V4)

Operation ID:: CreateProjectV4

Create a new project.

Parameters

Name	Key	Required	Type	Description
Name	name	True	string	The name of the project.
Color	color		string	The color of the project icon.
Parent Id	parent_id		string	The id of the parent project. Set to null for root projects
Is favorite	is_favorite		boolean	Whether the project is favorite (a true or false value).

Returns

A Todoist Project Object

Body: ProjectV4

Create a project [DEPRECATED]

Operation ID:: CreateProject

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

Operation ID:: CreateItemV2

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

Operation ID:: CreateItemV3

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

~~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 (V4)

Operation ID:: CreateItemV4

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		string	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		integer	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	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: TaskV2

Create a task [DEPRECATED]

Operation ID:: CreateItem

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

Operation ID:: ListLabelsV2

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

~~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]

Operation ID:: ListLabelsV3

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

~~List the labels configured in the Todoist account.~~

Returns

response: array of LabelV3

List labels (V4)

Operation ID:: ListLabelsV4

List the labels configured in the Todoist account.

Returns

response: array of LabelV4

List labels [DEPRECATED]

Operation ID:: ListLabels

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

Operation ID:: ListProjectsV2

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

~~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]

Operation ID:: ListProjectsV3

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

~~List all projects in the Todoist account.~~

Returns

response: array of ProjectV3

List projects (V4)

Operation ID:: ListProjectsV4

List all projects in the Todoist accounts.

Returns

response: array of ProjectV4

List projects [DEPRECATED]

Operation ID:: ListProjects

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

Operation ID:: ListItemsV2

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

~~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]

Operation ID:: ListItemsV3

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

~~List all tasks in the Todoist account.~~

Returns

response: array of Task

List tasks (V4)

Operation ID:: ListItemsV4

List all tasks in the Todoist account.

Returns

response: array of TaskV2

List tasks [DEPRECATED]

Operation ID:: ListItems

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

Operation ID:: ListItemsByProjectV2

This action has been deprecated. Please use List tasks by project (V4) 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 ItemV2	A collection of items

List tasks by project (V3) [DEPRECATED]

Operation ID:: ListItemsByProjectV3

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

~~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 (V4)

Operation ID:: ListItemsByProjectV4

List all tasks in a specific project.

Parameters

Name	Key	Required	Type	Description
Project Id	project_id	True	string	The unique identifier of the project.

Returns

response: array of TaskV2

List tasks by project [DEPRECATED]

Operation ID:: ListItemsByProject

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

Operation ID:: ShareProjectV2

This action has been deprecated. Please use Share a project (V4) 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 user email with whom to share the project.

Returns

A Todoist Project Object

Body: Project

Operation ID:: ShareProjectV4

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: ProjectV4

Operation ID:: ShareProject

This action has been deprecated. Please use Share a project (V4) 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) [DEPRECATED]

Operation ID:: UpdateLabelV2

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

Operation ID:: UpdateLabelV3

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

~~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 (V4)

Operation ID:: UpdateLabelV4

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		string	The color of the project icon.
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 (V4) 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) [DEPRECATED]

Operation ID:: UpdateProjectV2

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

Operation ID:: UpdateProjectV3

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

~~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 (V4)

Operation ID:: UpdateProjectV4

Update an existing project.

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	string	The unique identifier of the project.
Name	name	True	string	The name of the project.
Color	color		string	The color of the project icon.
Is favorite	is_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 (V4) 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) [DEPRECATED]

Operation ID:: UpdateItemV2

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

Operation ID:: UpdateItemV3

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

~~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 (V4)

Operation ID:: UpdateItemV4

Update an existing task.

Parameters

Name	Key	Required	Type	Description
Project Id	project_id	True	string	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		integer	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 (V4) 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) [DEPRECATED]	This action has been deprecated. Please use When a task is completed (V4) instead. ~~Triggers a new flow when a task is completed (premium users only).~~
When a task is completed (V4)	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 (V4) instead. ~~Triggers a new flow when a task is completed.~~
When a task is created (V2) [DEPRECATED]	This action has been deprecated. Please use When a task is created (V4) instead. ~~Trigers a new flow when a task is created.~~
When a task is created (V4)	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 (V4) instead. ~~Trigers a new flow when a task is created.~~

When a task is completed (V2) [DEPRECATED]

Operation ID:: OnItemCompletedV2

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

~~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 (V4)

Operation ID:: OnItemCompletedV4

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 CompletedItemV2	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 (V4) 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) [DEPRECATED]

Operation ID:: OnItemCreatedV2

This action has been deprecated. Please use When a task is created (V4) 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 ItemV2	A collection of items

When a task is created (V4)

Operation ID:: OnItemCreatedV4

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 ItemV3	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 (V4) 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

ProjectV4

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.
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 the project under the same parent.
Color	color	string	The color of the project.
Is Project Collapsed	collapsed	boolean	Is the project's sub-projects are collapsed.
Is Project Shared	shared	boolean	Is Project Shared
Is Project Marked as Deleted	is_deleted	boolean	Is Project marked as deleted
Is Project Archived	is_archived	boolean	Is Project Archived
Sync Id	sync_id	string	Identifier to find the match between different copies of shared projects.
Is Project Favorite	is_favorite	boolean	Is Project Favorite
Is Project Shared	inbox_project	boolean	Is Project Inbox
Is Project in Team Inbox	team_inbox	boolean	Is Project in Team Inbox
View Style	view_style	string	This determines the way the project is displayed within the Todoist clients.

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.

ItemV3

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	string	The owner of the task.
Project Id	project_id	string	The project where task resides.
Description	description	string	A description for the task.
Due Date	due.date	date-time	Due date.
Timezone	due.timezone	string	Timezone
String	due.string	string	Human-readable representation of due date. String always represents the due object in user's timezone.
Date Language	due.lang	string	The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).
Recurring Date	due.is_recurring	boolean	Boolean flag which is set to true if the due object represents a recurring due date.
Assigner Id	assigned_by_uid	string	The id of the user who assigns the current task. For shared projects only.
Assignee Id	responsible_uid	string	The id of user who is responsible for accomplishing the current task. For shared projects only.
Is Task Completed	checked	boolean	Whether the task is marked as completed (where 1 is true and 0 is false).
Date Completed	completed_at	date-time	The date when the task was completed.
Date Created	added_at	date-time	The date when the task was created.
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
Task Priority	priority	integer	The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).
Section ID	section_id	string	The ID of the parent section.
Collapsed	collapsed	boolean	Whether the task’s sub-tasks are collapsed (where 1 is true and 0 is false).
Labels	labels	array of string	The task's labels
Creator Id	added_by_uid	string	The ID of the user who created the task. For shared projects only.
Amount	duration.amount	integer	The amount of time the task will take.
Unit	duration.unit	string	The unit of time that the amount represents.

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.

TaskV2

A Todoist Task Object

Name	Path	Type	Description
Task Id	id	string	The id of the task.
Is Task Completed	is_completed	boolean	Is task completed
Project Id	project_id	string	The project where task resides.
Section Id	section_id	string	Id of section task belongs to.
Parent Id	parent_id	string	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.
Description	description	string	A description for the task.
Due Date	due.date	date-time	Due date.
Timezone	due.timezone	string	Timezone
String	due.string	string	Human-readable representation of due date. String always represents the due object in user's timezone.
Date Time	due.datetime	date-time	Only returned if exact due time set.
Recurring Date	due.is_recurring	boolean	Boolean flag which is set to true if the due object represents a recurring due date.
Creator Id	creator_id	string	The ID of the user who created the task. Set to null for root tasks.
Assignee Id	assignee_id	string	The responsible user ID. Set to null for root tasks.
Assigner Id	assigner_id	string	The ID of the user who assigned the task. Set to null for root tasks.
Amount	duration.amount	integer	The amount of time the task will take.
Unit	duration.unit	string	The unit of time that the amount represents.

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.

CompletedItemV2

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	string	The id of the completed task.
Task Owner	user_id	string	The owner of the task.
Project Id	project_id	string	The project where task resides.
Project Id	section_id	string	The project where task resides.
Task Title	content	string	The title of the task.
Date Completed	completed_at	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.
dynamicProperties	item_object.dynamicProperties	object

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

LabelV4

A Todoist Label Object

Name	Path	Type	Description
Label Id	id	string	The id of the label.
Label Name	name	string	The name of the label.
Color	color	string	The color of the label icon. Refer to the name column in the Colors guide for more info.
Item 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	boolean	Whether the label is marked as deleted (a true or false value).
IsFavorite	is_favorite	boolean	Whether the label is favorite (a true or false value).

Del via

Todoist

Known issues and limitations

1. Connections

Throttling Limits

Actions

Create a label (V2) [DEPRECATED]

Parameters

Returns

Create a label (V3) [DEPRECATED]

Parameters

Returns

Create a label (V4)

Parameters

Returns

Create a label [DEPRECATED]

Parameters

Returns

Create a project (V2) [DEPRECATED]

Parameters

Returns

Create a project (V3) [DEPRECATED]

Parameters

Returns

Create a project (V4)

Parameters

Returns

Create a project [DEPRECATED]

Parameters

Returns

Create a task (V2) [DEPRECATED]

Parameters

Returns

Create a task (V3) [DEPRECATED]

Parameters

Returns

Create a task (V4)

Parameters

Returns

Create a task [DEPRECATED]

Parameters

Returns

List labels (V2) [DEPRECATED]

Returns

List labels (V3) [DEPRECATED]

Returns

List labels (V4)

Returns

List labels [DEPRECATED]

Returns

List projects (V2) [DEPRECATED]

Returns

List projects (V3) [DEPRECATED]

Returns

List projects (V4)

Returns

List projects [DEPRECATED]

Returns

List tasks (V2) [DEPRECATED]

Returns

List tasks (V3) [DEPRECATED]

Returns

List tasks (V4)

Returns

List tasks [DEPRECATED]

Returns

List tasks by project (V2) [DEPRECATED]

Parameters

Returns

List tasks by project (V3) [DEPRECATED]

Parameters

Returns

List tasks by project (V4)

Parameters

Returns

List tasks by project [DEPRECATED]

Parameters

Returns

Share a project (V2) [DEPRECATED]

Parameters