Microsoft To Do
API actions for the Microsoft To Do integration.
Microsoft To Do
Create, update, and organize tasks and task lists in Microsoft To Do.
Complete task
Mark a task as completed in Microsoft To Do.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The task list ID. |
task_id | string | Yes | The task ID to complete. |
Response
{
"list_id": "list123",
"result": {
"status": "completed"
},
"task_id": "task123"
}Create task
Create a new task in Microsoft To Do.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The ID of the To Do list to add the task to. |
title | string | Yes | Task title. |
body | string | No | Optional task note. |
due_datetime | string | No | Optional due date and time, for example 2026-07-15T09:00:00. |
time_zone | string | No | Time zone for the due date and time. |
importance | string | No | Task importance: low, normal, or high. |
Response
{
"list_id": "list123",
"task": {
"id": "task123",
"title": "New Task"
}
}List task lists
List all task lists in Microsoft To Do.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
top | number | No | Optional maximum number of task lists to return. |
Response
{
"lists": [
{
"displayName": "My Tasks",
"id": "list123"
}
]
}List tasks
List tasks in a Microsoft To Do task list.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The ID of the list to get tasks from. |
top | number | No | Optional maximum number of tasks to return. |
Response
{
"list_id": "list123",
"tasks": [
{
"id": "task1",
"title": "Task 1"
}
]
}Update task due date
Update the due date of a task in Microsoft To Do.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The task list ID. |
task_id | string | Yes | The task ID to update. |
due_datetime | string | Yes | New due date and time, for example 2026-07-15T09:00:00. |
time_zone | string | No | Time zone for the due date and time (defaults to UTC). |
Response
{
"list_id": "list123",
"result": {
"dueDateTime": {
"dateTime": "2024-12-31T23:59:59",
"timeZone": "UTC"
}
},
"task_id": "task123"
}