Microsoft 365 A3-A5. Customers with one or more eligible Microsoft 365 subscriptions will see user-level licenses for Microsoft To Do. You can use these licenses to manage individual access to the Microsoft To Do apps for Windows, iOS, and Android, as well as control visibility of the Microsoft To Do tile in the Microsoft 365 app launcher. With My Day and suggestions, it's easier than ever to focus on your most important tasks. When you first open To Do each day, you'll see an empty My Day list where you can enter the tasks you’d like to focus on for the day. After using Microsoft To Do for at least one day, you’ll also be able to add tasks from suggestions. Create a list To create a new list, select + New List in your list menu. This will create an untitled list that you can rename. Download this app from Microsoft Store for Windows 10, Windows 10 Mobile, Windows 10 Team (Surface Hub). See screenshots, read the latest customer reviews, and compare ratings for Microsoft To Do: Lists, Tasks & Reminders. Just tap or click the list group icon to the right of +New List to create a new list group. This will create a group with the name “Untitled group”. To rename it, just tap or click to select “Untitled group” and begin typing the new group name. To add lists to a group, click.
-->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.
|
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). |
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.
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
Microsoft To Do List Instructions
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 | 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. |
Whether you need to buy a bottle of milk on the way home or complete the project proposal at work, our life consists of tasks. Up until recently, there was no good option to manage individual tasks in SharePoint and Office 365. That changed though with the introduction of Microsoft To Do.
What is Microsoft To Do?
Microsoft To Do is a cloud-based personal task management tool. It is part of an Office 365 suite, so that means that it is accessible, just like the rest of Office 365 apps in the cloud (read: from any device with an internet connection).
Microsoft To Do List Template
Microsoft To Do vs. Planner
Unlike Planner, which is a TEAM task management tool, To Do is strictly an app that is accessible just by the user (unless you share your tasks/lists with others). Using an analogy of OneDrive and SharePoint, where OneDrive is personal storage space in the cloud, while SharePoint is a team collaboration tool, To Do is a personal task management tool, unlike Planner.
Microsoft To Do vs. Outlook Tasks
Remember how ancient Task experience was with Outlook Tasks?
Old Task Experience in Outlook Web
Well, guess what, Microsoft To Do is a replacement for Outlook Tasks now!
NOTE: Since Microsoft To Do is a web-based application, the desktop Outlook task experience is still the same and did not change.
Example of a Task List in Outlook Desktop App
Microsoft To Do List Widget
What are Microsoft To Do’s core features?
List functionality
Tasks can be organized into Lists. A list is essentially a group of related tasks (i.e., shopping list, things to pack for vacation list).
Groups
You can take it one step further and group lists into Groups! For example, if you have a shopping list + a list of activities to do around the house this weekend, you can group the two separate lists into one group called Home Tasks. It is just another way for you to organize tasks, that’s all!
My Day
My Day is a built-in list that allows you to concentrate on Tasks you deem important on a given date.
Mobile App
Just like with many other Office 365 Apps, To Do has its a mobile app so you can access and complete the tasks on the go.
Integration with Planner
Microsoft To Do List
Microsoft To Do integrates natively with Planner and automatically pulls in the tasks from all the plans you are part of. This one is huge! It essentially allows you to access both your personal (i.e., buy milk) and work-related (approve a document) tasks all in one place.