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

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.