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


Operations listed here will not be affected by API deprecation.


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.

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

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.

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)

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

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.

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)

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)

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

Returns a list of all the to-do lists.

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.

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

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

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.

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.

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)

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)

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.

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.

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)

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)

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]

Triggers when a new to-do is created.

Returns

A Microsoft To-Do object.

Body
ToDo

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]

Triggers when a to-do is updated.

Returns

A Microsoft To-Do object.

Body
ToDo

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.