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 Government regions
     -   Azure China regions
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Add a to-do

This operation is used to create a to-do in the specified to-do list (defaults to 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).

Get a to-do

This operation is used to get the to-Do with the given Id.

List all to-do lists

Returns a list of all the to-do lists.

Add a to-do

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

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

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

List all to-do lists

Returns a list of all the to-do lists.

Returns

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.

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.

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.