Partilhar via

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:

  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]

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

Share a project (V2) [DEPRECATED]

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

Share a project (V4)

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

Share a project [DEPRECATED]

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