In Internet Explorer, click Tools, and then click Internet Options. On the Security tab, click the Trusted Sites icon. Click Sites and then add these website addresses one at a time to the list: You can only add one address at a time and you must click Add after each one. Ask the Microsoft Community. We're here to help! Post questions, follow discussions, share your knowledge. Learn how to get started.
-->Microsoft To-Do is an intelligent task management app that makes it easy to plan and manage your day. Connect to Microsoft To-Do to manage your tasks from various services. You can perform actions such as creating 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 China regions |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://todo.microsoft.com/tasks/ |
Known Issues and Limitations
- Due to Graph API limitations 'Assigned To' field is not populated in operations response
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
| Frequency of trigger polls | 1 | 120 seconds |
Actions
| Add a to-do (V2) [DEPRECATED] | This action has been deprecated. Please use Add a to-do (V3) instead.
|
| Add a to-do (V3) (Preview) | This operation is used to create a to-do in the specified to-do list. |
| Add a to-do [DEPRECATED] | This action has been deprecated. Please use Add a to-do (V3) instead.
|
| Create a to-do list (V2) (Preview) | This operation is used to create a new to-do list. |
| Create a to-do list [DEPRECATED] | This action has been deprecated. Please use Create a to-do list (V2) instead.
|
| Delete a to-do list (Preview) | This operation is used to delete a specific to-do list. |
| Delete to-do (V2) (Preview) | This operation is used to delete a task. |
| Delete to-do [DEPRECATED] | This action has been deprecated. Please use Delete to-do (V2) instead.
|
| Get a to-do (V2) [DEPRECATED] | This action has been deprecated. Please use Get a to-do (V3) instead.
|
| Get a to-do (V3) (Preview) | This operation is used to get the to-do with the given Id. |
| Get a to-do [DEPRECATED] | This action has been deprecated. Please use Get a to-do (V3) instead.
|
| Get a to-do list (V2) (Preview) | This operation is used to get a specific to-do list. |
| Get a to-do list [DEPRECATED] | This action has been deprecated. Please use Get a to-do list (V2) instead.
|
| List all to-do's (Preview) | This operation is used to retrieve all to-do's from all lists. |
| List all to-do lists (V2) (Preview) | Returns a list of all the to-do lists. |
| List all to-do lists [DEPRECATED] | This action has been deprecated. Please use List all to-do lists (V2) instead.
|
| List to-do's by folder (V2) (Preview) | This operation is used to retrieve all to-do's from a specific list. |
| List to-do's by folder [DEPRECATED] | This action has been deprecated. Please use List to-do's by folder (V2) instead.
|
| Update a to-do list (Preview) | This operation is used to update a specific to-do list. |
| Update to-do (V2) (Preview) | This operation is used to update a specific to-do. |
| Update to-do [DEPRECATED] | This action has been deprecated. Please use Update to-do (V2) instead.
|
Microsoft To Do Online
Add a to-do (V2) [DEPRECATED]
This action has been deprecated. Please use Add a to-do (V3) instead.
This operation is used to create a to-do in the specified to-do list (defaults to To-Do).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | string | To-do list | ||
Due Date | DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | |
| DateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | ||
Start Date | DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | |
| Importance | string | Low, normal or high. | ||
Subject | Subject | True | string | Brief description or title of the to-do. |
| Status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | ||
Sensitivity | Sensitivity | string | Indicates the level of privacy for the event. | |
| Content | html | The content. | ||
Category | Categories | string | Associated with the to-do. | |
| IsReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
Returns
A Microsoft To-Do object.
- Body
- ToDoHtml
Add a to-do (V3) (Preview)
This operation is used to create a to-do in the specified to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
Due Date | dateTime | date-time | YYYY-MM-DDThh:mm:ss | |
| dateTime | date-time | YYYY-MM-DDThh:mm:ss | ||
Importance | importance | string | Low, normal or high. | |
| title | True | string | Brief description or title of the to-do. | |
Status | status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | |
| content | html | The content of the item. | ||
Is Reminder On | isReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
Returns
A Microsoft To-Do object.
Add a to-do [DEPRECATED]
This action has been deprecated. Please use Add a to-do (V3) instead.
This operation is used to create a to-do in the specified to-do list (defaults to To-Do).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | string | To-do list | ||
Due Date | DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | |
| DateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | ||
Start Date | DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | |
| Importance | string | Low, normal or high. | ||
Subject | Subject | True | string | Brief description or title of the to-do. |
| Status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | ||
Sensitivity | Sensitivity | string | Indicates the level of privacy for the event. | |
| ContentType | string | Text=0, HTML=1 | ||
Content | Content | string | The text or HTML content. | |
| Categories | string | Associated with the to-do. | ||
Is Reminder On | IsReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
Returns
A Microsoft To-Do object.
Create a to-do list (V2) (Preview)
This operation is used to create a new to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| displayName | True | string | List name |
Returns
An Microsoft To-Do list.
- Body
- TodoList_V2
Create a to-do list [DEPRECATED]
This action has been deprecated. Please use Create a to-do list (V2) instead.
This operation is used to create a new to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| name | True | string | List name |
Returns
An Microsoft To-Do list.
- Body
- TodoList
Delete a to-do list (Preview)
This operation is used to delete a specific to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Delete to-do (V2) (Preview)
This operation is used to delete a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
Delete to-do [DEPRECATED]
This action has been deprecated. Please use Delete to-do (V2) instead.
This operation is used to delete a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
Get a to-do (V2) [DEPRECATED]
This action has been deprecated. Please use Get a to-do (V3) instead.
This operation is used to get the to-do with the given Id.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
Returns
A Microsoft To-Do object.
Get a to-do (V3) (Preview)
This operation is used to get the to-do with the given Id.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
Returns
A Microsoft To-Do object.
Get a to-do [DEPRECATED]
This action has been deprecated. Please use Get a to-do (V3) instead.
This operation is used to get the to-Do with the given Id.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| id | True | string | To-do Id |
Returns
A Microsoft To-Do object.
- Body
- ToDo
Get a to-do list (V2) (Preview)
This operation is used to get a specific to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Returns
An Microsoft To-Do list.
- Body
- TodoList_V2
Get a to-do list [DEPRECATED]
This action has been deprecated. Please use Get a to-do list (V2) instead.
This operation is used to get a specific to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| id | True | string | To-do list |
Returns
An Microsoft To-Do list.
- Body
- TodoList
List all to-do's (Preview)
This operation is used to retrieve all to-do's from all lists.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| $top | integer | Total number of entries to retrieve (default = 10, maximum = 999). |
Microsoft To Do Online Dark Mode
Returns
- response
- array of ToDo
List all to-do lists (V2) (Preview)
Returns a list of all the to-do lists.
Returns
List all to-do lists [DEPRECATED]
This action has been deprecated. Please use List all to-do lists (V2) instead.
Returns a list of all the to-do lists.
Returns
List to-do's by folder (V2) (Preview)
This operation is used to retrieve all to-do's from a specific list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
Top Count | $top | integer | Total number of entries to retrieve (default = 10, maximum = 999). |
Returns
List to-do's by folder [DEPRECATED]
This action has been deprecated. Please use List to-do's by folder (V2) instead.
This operation is used to retrieve all to-do's from a specific list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
Top Count | $top | integer | Total number of entries to retrieve (default = 10, maximum = 999). |
Returns
Update a to-do list (Preview)
This operation is used to update a specific to-do list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
Name | displayName | True | string | List name |
Returns
An Microsoft To-Do list.
Update to-do (V2) (Preview)
This operation is used to update a specific to-do.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
| dateTime | date-time | YYYY-MM-DDThh:mm:ss | ||
Reminder Date-Time | dateTime | date-time | YYYY-MM-DDThh:mm:ss | |
| importance | string | Low, normal or high. | ||
Title | title | string | Brief description or title of the to-do. | |
| status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | ||
Content | content | html | The content of the item. | |
| isReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
Returns
A Microsoft To-Do object.
- Body
- ToDo_V2
Update to-do [DEPRECATED]
This action has been deprecated. Please use Update to-do (V2) instead.
This operation is used to update a specific to-do.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list | |
To-do task | id | True | string | To-do task |
| DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | ||
Reminder Date-Time | DateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
| DateTime | date-time | YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ (note the time portion will be ignored) | ||
Importance | Importance | string | Low, normal or high. | |
| Subject | string | Brief description or title of the to-do. | ||
Status | Status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | |
| Sensitivity | string | Indicates the level of privacy for the event. | ||
Content Type | ContentType | string | Text=0, HTML=1 | |
| Content | string | The text or HTML content. | ||
Category | Categories | string | Associated with the to-do. | |
| IsReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
Returns
A Microsoft To-Do object.
- Body
- ToDo
Triggers
Microsoft To Do Download
| When a new to-do in a specific folder is created (V2) (Preview) | Triggers when a new to-do in a specific folder is created. |
| When a new to-do in a specific folder is created [DEPRECATED] | This action has been deprecated. Please use When a new to-do in a specific folder is created (V2) instead.
|
| When a new to-do is created [DEPRECATED] | Triggers when a new to-do is created. |
| When a to-do in a specific folder is updated (V2) (Preview) | Triggers when a to-do in a specific folder is updated. |
| When a to-do in a specific folder is updated [DEPRECATED] | This action has been deprecated. Please use When a to-do in a specific folder is updated (V2) instead.
|
| When a to-do is updated [DEPRECATED] | Triggers when a to-do is updated. |
When a new to-do in a specific folder is created (V2) (Preview)
Triggers when a new to-do in a specific folder is created.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo_V2
When a new to-do in a specific folder is created [DEPRECATED]
This action has been deprecated. Please use When a new to-do in a specific folder is created (V2) instead.
Triggers when a new to-do in a specific folder is created.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
When a new to-do is created [DEPRECATED]
Triggers when a new to-do is created.
Returns
A Microsoft To-Do object.
When a to-do in a specific folder is updated (V2) (Preview)
Triggers when a to-do in a specific folder is updated.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo_V2
When a to-do in a specific folder is updated [DEPRECATED]
This action has been deprecated. Please use When a to-do in a specific folder is updated (V2) instead.
Triggers when a to-do in a specific folder is updated.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| folderId | True | string | To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
When a to-do is updated [DEPRECATED]
Triggers when a to-do is updated.
Returns
A Microsoft To-Do object.
Definitions
ToDo
A Microsoft To-Do object.
| Name | Path | Type | Description |
|---|---|---|---|
| id | string | Unique identifier of the to-do. | |
Created Date-Time | createdDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| lastModifiedDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Categories | categories | array of string | Collection of category names associated with the to-do. |
| assignedTo | string | Name of the person who has been assigned the to-do. | |
Content Type | body.contentType | string | Text=0, HTML=1 |
| body.content | string | The text or HTML content. | |
Date-Time | completedDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| dueDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Importance | importance | string | Low, normal or high. |
| isReminderOn | boolean | True if an alert is set to remind the user of the to-do. | |
Owner | owner | string | Name of the person who created the to-do. |
| parentFolderId | string | Unique identifier of the parent folder. | |
Date-Time | reminderDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| startDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Status | status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. |
| subject | string | Brief description or title of the to-do. |
ToDoHtml
A Microsoft To-Do object.
| Name | Path | Type | Description |
|---|---|---|---|
| id | string | Unique identifier of the to-do. | |
Created Date-Time | createdDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| lastModifiedDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Categories | categories | array of string | Collection of category names associated with the to-do. |
| assignedTo | string | Name of the person who has been assigned the to-do. | |
Content | body.content | html | The content. |
| completedDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Date | dueDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| importance | string | Low, normal or high. | |
Is reminder on | isReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
| owner | string | Nec card reader driver download. Name of the person who created the to-do. | |
Parent folder identifier | parentFolderId | string | Unique identifier of the parent folder. |
| reminderDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Date | startDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. | |
Subject | subject | string | Brief description or title of the to-do. |
TodoList
An Microsoft To-Do list.
| Name | Path | Type | Description |
|---|---|---|---|
| id | string | Unique identifier of the to-do list. | |
Name | name | string | Name of the to-do list. |
| isDefaultFolder | boolean | True if this is the default to-do list. |
TodoList_V2
An Microsoft To-Do list.
| Name | Path | Type | Description |
|---|---|---|---|
| id | string | Unique identifier of the to-do list. | |
Name | displayName | string | Name of the to-do list. |
| wellknownListName | string | Property indicating the well-known list name if the given list is a well-known list. Possible values are: none, defaultList, flaggedEmails, unknownFutureValue. | |
Is owner | isOwner | boolean | True if the user is owner of the given task list. |
| isShared | boolean | True if the task list is shared with other users. |
ToDo_V2
A Microsoft To-Do object.
| Name | Path | Type | Description |
|---|---|---|---|
| id | string | Unique identifier of the to-do. | |
Created Date-Time | createdDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| lastModifiedDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) | |
Content Type | body.contentType | string | The type of the content. Possible values are text and html. |
| body.content | string | The content of the item. | |
Modified Date-Time | bodyLastModifiedDateTime | date-time | YYYY-MM-DDThh:mm:ssZ (UTC format) |
| completedDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ss | |
Date | dueDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ss |
| importance | string | Low, normal or high. | |
Is reminder on | isReminderOn | boolean | True if an alert is set to remind the user of the to-do. |
| reminderDateTime.dateTime | date-time | YYYY-MM-DDThh:mm:ss | |
Status | status | string | Indicates state or progress of the to-do - not started, in progress, completed, waiting on others or deferred. |
| title | string | Brief description or title of the to-do. |