Microsoft To Do
App · To-Do Lists · 5 actions
Create, update, and organize tasks and task lists in Microsoft To Do.
Actions
| Action | What it does |
|---|---|
| Complete task | Mark a task as completed in Microsoft To Do. |
| Create task | Create a new task in Microsoft To Do. |
| List task lists | List all task lists in Microsoft To Do. |
| List tasks | List tasks in a Microsoft To Do task list. |
| Update task due date | Update the due date of a task in Microsoft To Do. |
Complete task
Mark a task as completed in Microsoft To Do.
Inputs
- List ID
list_idtextRequired - The task list ID.
- Task ID
task_idtextRequired - The task ID to complete.
Outputs
list_idtext- The list ID.
resultobject- The updated task.
task_idtext- The task ID.
Example output
{
"list_id": "list123",
"result": {
"status": "completed"
},
"task_id": "task123"
}Create task
Create a new task in Microsoft To Do.
Inputs
- List ID
list_idtextRequired - The ID of the To Do list to add the task to.
- Title
titletextRequired - Task title.
- Body
bodytext - Optional task note.
- Due date and time
due_datetimedate and time - Optional due date and time, for example 2026-07-15T09:00:00.
- Time zone
time_zonetext - Time zone for the due date and time.
- Importance
importancetext - Task importance: low, normal, or high.
Outputs
list_idtext- The list ID.
taskobject- The created task.
Example output
{
"list_id": "list123",
"task": {
"id": "task123",
"title": "New Task"
}
}List task lists
List all task lists in Microsoft To Do.
Inputs
- Maximum results
topnumber - Optional maximum number of task lists to return.
Outputs
listslist- List of task lists.
Example output
{
"lists": [
{
"displayName": "My Tasks",
"id": "list123"
}
]
}List tasks
List tasks in a Microsoft To Do task list.
Inputs
- List ID
list_idtextRequired - The ID of the list to get tasks from.
- Maximum results
topnumber - Optional maximum number of tasks to return.
Outputs
list_idtext- The list ID.
taskslist- List of tasks.
Example output
{
"list_id": "list123",
"tasks": [
{
"id": "task1",
"title": "Task 1"
}
]
}Update task due date
Update the due date of a task in Microsoft To Do.
Inputs
- List ID
list_idtextRequired - The task list ID.
- Task ID
task_idtextRequired - The task ID to update.
- Due date and time
due_datetimedate and timeRequired - New due date and time, for example 2026-07-15T09:00:00.
- Time zone
time_zonetext - Time zone for the due date and time (defaults to UTC).
Outputs
list_idtext- The list ID.
resultobject- The updated task.
task_idtext- The task ID.
Example output
{
"list_id": "list123",
"result": {
"dueDateTime": {
"dateTime": "2024-12-31T23:59:59",
"timeZone": "UTC"
}
},
"task_id": "task123"
}