- To Do App Microsoft Download
- Todo App Microsoft Office
- Download Microsoft To Do Desktop
- App Store Microsoft Todo
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.
Microsoft To Do. Trying to sign you in. Terms of use Privacy & cookies. Privacy & cookies. Microsoft To Do. Microsoft To Do. To Do gives you focus, from work to play.
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. 
 | 
Add a to-do (V2) [DEPRECATED]
To Do App Microsoft Download
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). | 
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
| 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.
Todo App Microsoft Office
Parameters
| Name | Key | Required | Type | Description | 
|---|---|---|---|---|
| folderId | True | string | To-do list | 
Download Microsoft To Do Desktop
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
App Store Microsoft Todo
| 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 | 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. | 
