Microsoft To Do



-->

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

This simple and accessible to-do list uses a table and conditional formatting. Add a row for a new task, set the priority, dates, and notes. Once you have set the completion to 100%, Excel automatically checks the item off as done. Microsoft To Do. To Do verleiht Ihnen Fokus, aus Arbeit wird Leichtigkeit. Weitere Informationen. To Do herunterladen.

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

Plan and connect with Microsoft To Do Use My Day and suggestions to plan each day and focus on accomplishing your most important tasks. Connect Microsoft To Do with Outlook to see your tasks there and create new ones from flagged email. Add tasks to My Day. Microsoft Outlook has integration with To Do, a task management tool that can help you be a bit more productive. Here's how you can use it. The 'My Day' view lets you add tasks you want to.

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

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

Microsoft to do login

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]

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)

How To Use Microsoft To-do

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

Microsoft To Do Tutorial

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

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

App
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

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.

Microsoft To-do Preview

ToDo_V2

Microsoft To Do Teams

Microsoft to-do list

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.