Microsoft Todo

Create and manage task lists and tasks in Microsoft Todo from workflows.

Actions

List Lists

Returns all task lists in the account.

Output	Type	Description
lists	array	Task list objects with id, displayName, isOwner

Create List

Creates a new task list.

Input	Required	Description
Display Name	Yes	Name for the new task list

Output	Type	Description
list	object	Created list with id, displayName

Get List

Retrieves a task list by ID.

Input	Required	Description
List ID	Yes	The task list ID

Output	Type	Description
list	object	Task list object

List Tasks

Returns tasks in a specific list.

Input	Required	Description
List ID	Yes	The task list to query

Output	Type	Description
tasks	array	Task objects with id, title, status, dueDateTime, body

Create Task

Creates a new task in a list.

Input	Required	Description
List ID	Yes	Target task list
Title	Yes	Task title
Body	No	Task notes or description
Due Date	No	Due date (ISO 8601)
Importance	No	low, normal, or high

Output	Type	Description
task	object	Created task with id, title

Get Task

Retrieves a specific task.

Input	Required	Description
List ID	Yes	List containing the task
Task ID	Yes	Task ID

Output	Type	Description
task	object	Full task object

Update Task

Updates an existing task.

Input	Required	Description
List ID	Yes	List containing the task
Task ID	Yes	Task to update
Title	No	New title
Status	No	notStarted, inProgress, or completed
Due Date	No	New due date
Body	No	Updated notes

Output	Type	Description
task	object	Updated task object

List Checklist Items

Returns checklist items within a task.

Input	Required	Description
List ID	Yes	List ID
Task ID	Yes	Task ID

Output	Type	Description
checklistItems	array	Checklist items with id, displayName, isChecked

Create Checklist Item

Adds a checklist item to a task.

Input	Required	Description
List ID	Yes	List ID
Task ID	Yes	Task ID
Display Name	Yes	Text for the checklist item
Is Checked	No	Whether the item starts checked