Microsoft To-Do (Consumer)
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 - US Department of Defense (DoD) |
Power Automate | Standard | All Power Automate regions except the following: - 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 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://todo.microsoft.com/tasks/ |
To Do API has most of the Outlook Task capabilities. Please note that outlookTaskGroup entity, extended properties and assignedTo, owner properties of outlookTask entity won’t be available in To Do API.
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Frequency of trigger polls | 1 | 120 seconds |
Add a to-do |
This operation is used to create a to-do in the specified to-do list. |
Create a to-do list |
This operation is used to create a new to-do list. |
Delete a to-do list |
This operation is used to delete a specific to-do list. |
Delete to-do |
This operation is used to delete a task. |
Get a to-do |
This operation is used to get the to-do with the given Id. |
Get a to-do list |
This operation is used to get a specific to-do list. |
List all to-do lists |
Returns a list of all the to-do lists. |
List to-do's by folder |
This operation is used to retrieve all to-do's from a specific list. |
Update a to-do list |
This operation is used to update a specific to-do list. |
Update to-do |
This operation is used to update a specific to-do. |
This operation is used to create a to-do in the specified to-do list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Due Date
|
dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
|
Reminder Date-Time
|
dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
|
Importance
|
importance | string |
Low, normal or high. |
|
Title
|
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
|
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.
- Body
- ToDo
This operation is used to create a new to-do list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name
|
displayName | True | string |
List name |
Returns
An Microsoft To-Do list.
- Body
- TodoList
This operation is used to delete a specific to-do list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
This operation is used to delete a task.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
To-do task
|
id | True | string |
To-do task |
This operation is used to get the to-do with the given Id.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
To-do task
|
id | True | string |
To-do task |
Returns
A Microsoft To-Do object.
- Body
- ToDo
This operation is used to get a specific to-do list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Returns
An Microsoft To-Do list.
- Body
- TodoList
This operation is used to retrieve all to-do's from a specific list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Top Count
|
$top | integer |
Total number of entries to retrieve (default = 10, maximum = 999). |
Returns
- response
- array of ToDo
This operation is used to update a specific to-do list.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Name
|
displayName | True | string |
List name |
Returns
An Microsoft To-Do list.
- Body
- TodoList
This operation is used to update a specific to-do.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
To-do task
|
id | True | string |
To-do task |
Due Date
|
dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
|
Reminder Date-Time
|
dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
|
Importance
|
importance | string |
Low, normal or high. |
|
Title
|
title | 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
|
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.
- Body
- ToDo
When a new to-do in a specific folder is created |
Triggers when a new to-do in a specific folder is created. |
When a to-do in a specific folder is updated |
Triggers when a to-do in a specific folder is updated. |
Triggers when a new to-do in a specific folder is created.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
Triggers when a to-do in a specific folder is updated.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
To-do List
|
folderId | True | string |
To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
An Microsoft To-Do list.
Name | Path | Type | Description |
---|---|---|---|
Id
|
id | string |
Unique identifier of the to-do list. |
Name
|
displayName | string |
Name of the to-do list. |
Well-known name
|
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. |
Is shared
|
isShared | boolean |
True if the task list is shared with other users. |
A Microsoft To-Do object.
Name | Path | Type | Description |
---|---|---|---|
Id
|
id | string |
Unique identifier of the to-do. |
Created Date-Time
|
createdDateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
Modified Date-Time
|
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. |
Content
|
body.content | string |
The content of the item. |
Modified Date-Time
|
bodyLastModifiedDateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
Date
|
completedDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
Date
|
dueDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ss |
Importance
|
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. |
Date-Time
|
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
|
title | string |
Brief description or title of the to-do. |