Microsoft To Do

-->

Microsoft To Do syncs your tasks across your devices, whether you use Android, iOS, Mac, Windows, or the web. To Do is also integrated with the Microsoft 365 suite of applications, including Outlook and Teams. In the first installment of our Six Tips series, we’ll focus on Windows 10 devices. Microsoft To-Do - Duplicate Recurring Tasks All my recurring tasks in the To-Do app are being duplicated. So when I mark a recurring task complete, an exact copy of that occurrence appears on the list with the same due date and sub tasks, but the task and all sub tasks are marked incomplete. Get Microsoft To Do. Whether you want to increase your productivity, decrease your stress levels, or just free up some mental space, Microsoft To Do makes it easy to plan your day and manage your life.

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:

ServiceClassRegions
Logic AppsStandardAll Logic Apps regions except the following:
- Azure China regions
Power AutomateStandardAll Power Automate regions except the following:
- US Government (GCC High)
- China Cloud operated by 21Vianet
Power AppsStandardAll Power Apps regions except the following:
- US Government (GCC High)
- China Cloud operated by 21Vianet
Contact
NameMicrosoft
URLMicrosoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
PublisherMicrosoft
Websitehttps://todo.microsoft.com/tasks/

Known Issues and Limitations

  • Due to Graph API limitations 'Assigned To' field is not populated in operations response

Throttling Limits

NameCallsRenewal Period
API calls per connection10060 seconds
Frequency of trigger polls1120 seconds

Actions

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).

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.

This operation is used to create a to-do in the specified to-do list (defaults to To-Do).

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.

This operation is used to create a new to-do list.

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.

This operation is used to delete a 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.

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.

This operation is used to get the to-Do with the given Id.

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.

This operation is used to get a specific to-do list.

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.

Returns a list of all the to-do lists.

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.

This operation is used to retrieve all to-do's from a specific list.

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.

This operation is used to update a specific to-do.

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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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. Application wizard. Please use Create a to-do list (V2) instead.

This operation is used to create a new to-do list.

Parameters

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
folderId True string

To-do list

Delete to-do (V2) (Preview)

This operation is used to delete a task.

Parameters

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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]

Microsoft

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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
$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

MicrosoftMicrosoft to do desktop app
NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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.

Triggers when a new to-do in a specific folder is created.

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.

Triggers when a to-do in a specific folder is updated.

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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
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

NameKeyRequiredTypeDescription
folderId True string

To-do list

Microsoft To Do Download Without Store

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.

NamePathTypeDescription
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.

NamePathTypeDescription
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.

NamePathTypeDescription
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.

NamePathTypeDescription
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.

NamePathTypeDescription
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.

Https://todo.microsoft.com/

-->

Microsoft To Do provides a simple way for people to manage their tasks and plan their day. Tasks are organized in task lists, which can be accessed across To Do clients, Outlook and Teams from any device.

To Do Windows app

Why integrate with To Do?

Ease of organizing and tracking tasks

Microsoft To Do helps you create a list for anything, from work assignments to home projects to groceries. You can keep track of deadlines by adding reminders, due dates, and notes. You can access your lists from anywhere with the Microsoft To Do apps for iOS, Android, Mac, Windows, and the web.

Integrate across Microsoft 365

To Do is the single destination for personal tasks in Microsoft 365. So it’s deeply integrated with Microsoft 365 hubs, Outlook, and Teams. Tasks created in those products sync with To Do so you can access and manage them across devices. To Do integration can help you reach millions of users who use To Do to gather tasks from Outlook and Teams into one integrated view.

Microsoft To Do App

Support task completion using linked resources

Microsoft To Do provides a new entity called linked resource, which you can use to create tasks that can link back to their original sources. You can use this to seamlessly integrate To Do in your workflow by creating tasks that link to your product or service.

Common To Do API operations

OperationRequest
List all the task listsGET https://graph.microsoft.com/v1.0/me/todo/lists
List all tasks in a task listGET https://graph.microsoft.com/v1.0/me/todo/lists/{todoTaskListId}/tasks
Create a new taskPOST https://graph.microsoft.com/v1.0/me/todo/lists/{todoTaskListId}/tasks
Update a taskPATCH https://graph.microsoft.com/v1.0/me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}
Delete a taskDELETE https://graph.microsoft.com/v1.0/me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}

API reference

Looking for the API reference for this service?