# Microsoft To Do

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

App · To-Do Lists · 5 actions. Web page: https://docs.lodol.com/docs/integrations/microsoft-todo

## Actions

### Complete task

Mark a task as completed in Microsoft To Do.

**Inputs**

- List ID (`list_id`, text, required): The task list ID.
- Task ID (`task_id`, text, required): The task ID to complete.

**Outputs**

- `list_id` (text): The list ID.
- `result` (object): The updated task.
- `task_id` (text): The task ID.

**Example output**

```json
{
  "list_id": "list123",
  "result": {
    "status": "completed"
  },
  "task_id": "task123"
}
```

### Create task

Create a new task in Microsoft To Do.

**Inputs**

- List ID (`list_id`, text, required): The ID of the To Do list to add the task to.
- Title (`title`, text, required): Task title.
- Body (`body`, text): Optional task note.
- Due date and time (`due_datetime`, date and time): Optional due date and time, for example 2026-07-15T09:00:00.
- Time zone (`time_zone`, text): Time zone for the due date and time.
- Importance (`importance`, text): Task importance: low, normal, or high.

**Outputs**

- `list_id` (text): The list ID.
- `task` (object): The created task.

**Example output**

```json
{
  "list_id": "list123",
  "task": {
    "id": "task123",
    "title": "New Task"
  }
}
```

### List task lists

List all task lists in Microsoft To Do.

**Inputs**

- Maximum results (`top`, number): Optional maximum number of task lists to return.

**Outputs**

- `lists` (list): List of task lists.

**Example output**

```json
{
  "lists": [
    {
      "displayName": "My Tasks",
      "id": "list123"
    }
  ]
}
```

### List tasks

List tasks in a Microsoft To Do task list.

**Inputs**

- List ID (`list_id`, text, required): The ID of the list to get tasks from.
- Maximum results (`top`, number): Optional maximum number of tasks to return.

**Outputs**

- `list_id` (text): The list ID.
- `tasks` (list): List of tasks.

**Example output**

```json
{
  "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_id`, text, required): The task list ID.
- Task ID (`task_id`, text, required): The task ID to update.
- Due date and time (`due_datetime`, date and time, required): New due date and time, for example 2026-07-15T09:00:00.
- Time zone (`time_zone`, text): Time zone for the due date and time (defaults to UTC).

**Outputs**

- `list_id` (text): The list ID.
- `result` (object): The updated task.
- `task_id` (text): The task ID.

**Example output**

```json
{
  "list_id": "list123",
  "result": {
    "dueDateTime": {
      "dateTime": "2024-12-31T23:59:59",
      "timeZone": "UTC"
    }
  },
  "task_id": "task123"
}
```