Microsoft To Do

App · To-Do Lists · 5 actions

Create, update, and organize tasks and task lists in Microsoft To Do.

Actions

ActionWhat it does
Complete taskMark a task as completed in Microsoft To Do.
Create taskCreate a new task in Microsoft To Do.
List task listsList all task lists in Microsoft To Do.
List tasksList tasks in a Microsoft To Do task list.
Update task due dateUpdate the due date of a task in Microsoft To Do.

Complete task

Mark a task as completed in Microsoft To Do.

Inputs

List IDlist_idtextRequired
The task list ID.
Task IDtask_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 IDlist_idtextRequired
The ID of the To Do list to add the task to.
TitletitletextRequired
Task title.
Bodybodytext
Optional task note.
Due date and timedue_datetimedate and time
Optional due date and time, for example 2026-07-15T09:00:00.
Time zonetime_zonetext
Time zone for the due date and time.
Importanceimportancetext
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 resultstopnumber
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 IDlist_idtextRequired
The ID of the list to get tasks from.
Maximum resultstopnumber
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 IDlist_idtextRequired
The task list ID.
Task IDtask_idtextRequired
The task ID to update.
Due date and timedue_datetimedate and timeRequired
New due date and time, for example 2026-07-15T09:00:00.
Time zonetime_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"
}

On this page