Todoist
![](https://connectoricons-prod.azureedge.net/releases/v1.0.1692/1.0.1692.3728/todoist/icon.png)
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 label (V3) [DEPRECATED] |
This action has been deprecated. Please use Create a label (V4) instead.
|
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 project (V2) [DEPRECATED] |
This action has been deprecated. Please use Create a project (V4) instead.
|
Create a project (V3) [DEPRECATED] |
This action has been deprecated. Please use Create a project (V4) instead.
|
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 task (V2) [DEPRECATED] |
This action has been deprecated. Please use Create a task (V4) instead.
|
Create a task (V3) [DEPRECATED] |
This action has been deprecated. Please use Create a task (V4) instead.
|
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.
|
List labels (V2) [DEPRECATED] |
This action has been deprecated. Please use List labels (V4) instead.
|
List labels (V3) [DEPRECATED] |
This action has been deprecated. Please use List labels (V4) instead.
|
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 projects (V2) [DEPRECATED] |
This action has been deprecated. Please use List projects (V4) instead.
|
List projects (V3) [DEPRECATED] |
This action has been deprecated. Please use List projects (V4) instead.
|
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 tasks (V2) [DEPRECATED] |
This action has been deprecated. Please use List tasks (V4) instead.
|
List tasks (V3) [DEPRECATED] |
This action has been deprecated. Please use List tasks (V4) instead.
|
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 tasks by project (V2) [DEPRECATED] |
This action has been deprecated. Please use List tasks by project (V4) instead.
|
List tasks by project (V3) [DEPRECATED] |
This action has been deprecated. Please use List tasks by project (V4) instead.
|
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.
|
Share a project (V2) [DEPRECATED] |
This action has been deprecated. Please use Share a project (V4) instead.
|
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.
|
Update a label (V2) [DEPRECATED] |
This action has been deprecated. Please use Update a label (V4) instead.
|
Update a label (V3) [DEPRECATED] |
This action has been deprecated. Please use Update a label (V4) instead.
|
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 a project (V2) [DEPRECATED] |
This action has been deprecated. Please use Update a project (V4) instead.
|
Update a project (V3) [DEPRECATED] |
This action has been deprecated. Please use Update a project (V4) instead.
|
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 a task (V2) [DEPRECATED] |
This action has been deprecated. Please use Update a task (V4) instead.
|
Update a task (V3) [DEPRECATED] |
This action has been deprecated. Please use Update a task (V4) instead.
|
Update a task (V4) |
Update an existing task. |
Update a task [DEPRECATED] |
This action has been deprecated. Please use Update a task (V4) instead.
|
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 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
- response
- array of ProjectV3
List projects (V4)
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 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
|
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
|
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
|
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.
|
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.
|
When a task is created (V2) [DEPRECATED] |
This action has been deprecated. Please use When a task is created (V4) instead.
|
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.
|
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). |