Compartilhar via


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/

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.

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

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.

Add a 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

Create a to-do list

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

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

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

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 list

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

List all to-do lists

Returns a list of all the to-do lists.

Returns

List to-do's by folder

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

Update to-do

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

Triggers

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.

When a new to-do in a specific folder is created

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 to-do in a specific folder is updated

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

Definitions

TodoList

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

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.