Compartilhar via

Microsoft To-Do (Consumer)

  • Reference

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

Operation ID:
CreateToDo

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

Operation ID:
CreateToDoList

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

Operation ID:
DeleteToDoList

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

Operation ID:
DeleteToDo

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

Operation ID:
GetToDo

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

Operation ID:
GetToDoList

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

Operation ID:
GetAllTodoLists

Returns a list of all the to-do lists.

Returns

response
array of TodoList

List to-do's by folder

Operation ID:
ListToDosByFolder

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

Operation ID:
UpdateToDoList

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

Operation ID:
UpdateToDo

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

Operation ID:
OnNewToDoInFolder

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

Operation ID:
OnUpdateToDoInFolder

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.