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
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
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/

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls1120 seconds

Actions

Add a to-do (V2)

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

Add a to-do [DEPRECATED]

This action has been deprecated. Please use Add a to-do (V2) 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

This operation is used to create a new 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 (V2)

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's

This operation is used to retrieve all to-do's from all lists.

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 to-do

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

Add a to-do (V2)

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.

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

Body
ToDoHtml

Add a to-do [DEPRECATED]

This action has been deprecated. Please use Add a to-do (V2) 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.

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

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
name True string

List name

Returns

An Microsoft To-Do list.

Body
TodoList

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 Id
id True string

To-do Id

Returns

A Microsoft To-Do object.

Body
ToDo

Get a to-do (V2)

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
id True string

To-do list

Returns

An Microsoft To-Do list.

Body
TodoList

List all to-do's

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

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

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

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 new to-do is created

Triggers when a new to-do 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 to-do is updated

Triggers when a to-do 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 new to-do is created

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

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

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.