Microsoft To-Do (Business)
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/ |
Known Issues and Limitations
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.
Deprecation of Outlook Tasks APIs
Graph Outlook Tasks APIs will stop returning data after February 20, 2023.
Operations listed here will be affected by API deprecation and will stop to return data after February 20, 2023.
- ListToDosByFolder
- ListAllToDos
- OnNewToDoInFolder
- OnNewToDo
- OnUpdateToDoInFolder
- OnUpdateToDo
- GetAllTodoLists
- GetToDoList
- GetToDo
- GetToDoV2
- CreateToDoList
- CreateToDo
- CreateToDoV2
- UpdateToDo
- DeleteToDo
Operations listed here will not be affected by API deprecation.
- ListToDosByFolderV2
- OnNewToDoInFolderV2
- OnUpdateToDoInFolderV2
- GetAllTodoListsV2
- GetToDoListV2
- GetToDoV3
- CreateToDoListV2
- CreateToDoV3
- UpdateToDoList
- UpdateToDoV2
- DeleteToDoList
- DeleteToDoV2
Devblogs on the To Do API release
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) |
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) |
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 |
This operation is used to delete a specific to-do list. |
| Delete to-do (V2) |
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) |
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) |
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 [DEPRECATED] |
This operation is used to retrieve all to-do's from all lists. |
| List all to-do lists (V2) |
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) |
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 |
This operation is used to update a specific to-do list. |
| Update to-do (V2) |
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 |
|---|---|---|---|---|
|
To-do List
|
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) |
|
|
Reminder Date-Time
|
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
|
Importance | string |
Low, normal or high. |
|
|
Subject
|
Subject | 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. |
|
|
Sensitivity
|
Sensitivity | string |
Indicates the level of privacy for the event. |
|
|
Content
|
Content | html |
The content. |
|
|
Categories
|
Categories | array of string |
Collection of category names 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.
- Body
- ToDoHtml
Add a to-do (V3)
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_V2
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 |
|---|---|---|---|---|
|
To-do List
|
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) |
|
|
Reminder Date-Time
|
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
|
Importance | string |
Low, normal or high. |
|
|
Subject
|
Subject | 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. |
|
|
Sensitivity
|
Sensitivity | string |
Indicates the level of privacy for the event. |
|
|
Content Type
|
ContentType | string |
Text=0, HTML=1 |
|
|
Content
|
Content | string |
The text or HTML content. |
|
|
Categories
|
Categories | array of string |
Collection of category names 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.
- Body
- ToDo
Create a to-do list (V2)
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_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
|
name | True | string |
List name |
Returns
An Microsoft To-Do list.
- Body
- TodoList
Delete a to-do list
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 |
Delete to-do (V2)
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 |
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 |
|---|---|---|---|---|
|
To-do List
|
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 |
|---|---|---|---|---|
|
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
Get a to-do (V3)
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_V2
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 |
|---|---|---|---|---|
|
To-do Id
|
id | True | string |
To-do Id |
Returns
A Microsoft To-Do object.
- Body
- ToDo
Get a to-do list (V2)
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_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 |
|---|---|---|---|---|
|
To-do List
|
id | True | string |
To-do list |
Returns
An Microsoft To-Do list.
- Body
- TodoList
List all to-do's [DEPRECATED]
This operation is used to retrieve all to-do's from all lists.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Top Count
|
$top | integer |
Total number of entries to retrieve (default = 10, maximum = 999). |
Returns
- response
- array of ToDo
List all to-do lists (V2)
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
- response
- array of TodoList
List to-do's by folder (V2)
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_V2
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 |
|---|---|---|---|---|
|
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
Update a to-do list
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_V2
Update to-do (V2)
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_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 |
|---|---|---|---|---|
|
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-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) |
|
|
Start Date
|
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
|
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
|
Sensitivity | string |
Indicates the level of privacy for the event. |
|
|
Content Type
|
ContentType | string |
Text=0, HTML=1 |
|
|
Content
|
Content | string |
The text or HTML content. |
|
|
Categories
|
Categories | array of string |
Collection of category names 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.
- Body
- ToDo
Triggers
| When a new to-do in a specific folder is created (V2) |
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) |
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)
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_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 |
|---|---|---|---|---|
|
To-do List
|
folderId | True | string |
To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
When a new to-do is created [DEPRECATED]
When a to-do in a specific folder is updated (V2)
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_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 |
|---|---|---|---|---|
|
To-do List
|
folderId | True | string |
To-do list |
Returns
A Microsoft To-Do object.
- Body
- ToDo
When a to-do is updated [DEPRECATED]
Definitions
ToDo
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) |
|
Categories
|
categories | array of string |
Collection of category names associated with the to-do. |
|
Assigned To
|
assignedTo | string |
Name of the person who has been assigned the to-do. |
|
Content Type
|
body.contentType | string |
Text=0, HTML=1 |
|
Content
|
body.content | string |
The text or HTML content. |
|
Date-Time
|
completedDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
Date
|
dueDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
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. |
|
Owner
|
owner | string |
Name of the person who created the to-do. |
|
Parent folder identifier
|
parentFolderId | string |
Unique identifier of the parent folder. |
|
Date-Time
|
reminderDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
Date
|
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
|
subject | string |
Brief description or title of the to-do. |
ToDoHtml
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) |
|
Categories
|
categories | array of string |
Collection of category names associated with the to-do. |
|
Assigned To
|
assignedTo | string |
Name of the person who has been assigned the to-do. |
|
Content
|
body.content | html |
The content. |
|
Date-Time
|
completedDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
Date
|
dueDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
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. |
|
Owner
|
owner | string |
Name of the person who created the to-do. |
|
Parent folder identifier
|
parentFolderId | string |
Unique identifier of the parent folder. |
|
Date-Time
|
reminderDateTime.dateTime | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format) |
|
Date
|
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
|
subject | string |
Brief description or title of the to-do. |
TodoList
An Microsoft To-Do list.
| Name | Path | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Unique identifier of the to-do list. |
|
Name
|
name | string |
Name of the to-do list. |
|
Is Default
|
isDefaultFolder | boolean |
True if this is the default to-do list. |
TodoList_V2
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. |
ToDo_V2
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. |