Partilhar via


Todoist

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

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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]

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]

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)

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]

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]

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]

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)

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]

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]

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]

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)

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]

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]

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]

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)

List the labels configured in the Todoist account.

Returns

response
array of LabelV4

List labels [DEPRECATED]

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]

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]

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

List all projects in the Todoist account.

Returns

List projects (V4)

List all projects in the Todoist accounts.

Returns

List projects [DEPRECATED]

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]

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]

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)

List all tasks in the Todoist account.

Returns

response
array of TaskV2

List tasks [DEPRECATED]

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]

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]

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)

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]

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]

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)

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]

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]

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]

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)

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]

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]

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]

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)

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]

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]

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]

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)

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]

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]

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)

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]

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]

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)

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]

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