--- title: Microsoft To Do slug: microsoft-to-do image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_microsoft-to-do.png createdAt: 2025-02-03T13:29:10.709Z --- The Microsoft To Do modules enable you to monitor, search, retrieve, create, edit or delete tasks and lists in your Microsoft To Do account. ## Getting Started with Microsoft To Do Prerequisites - A Microsoft account In order to use Microsoft To Do with Make, it is necessary to have a Microsoft To Do account. If you do not have one, you can create a Microsoft To Do account at[ todo.microsoft.com](http://todo.microsoft.com). ## Connect Microsoft To Do to Make To connect your Microsoft To Do account to Make follow the general instructions for [Connecting to services.](docId\:SO88FM6pkT0G-adKDDfzZ) Optional: **Click ​Show advanced settings**​ to enter your custom app client credentials, tenant ID, and add additional scopes as needed. If requested, use the following Redirect URI when creating your custom app: ​`https://www.integromat.com/oauth/cb/azure​​`. After you click the *Continue* button, Make will redirect you to the Microsoft To Do website where you will be prompted to grant Make access to your account. Confirm the dialog by clicking the *Yes *button. ## Task :::ExpandableHeading{isOpen="true"} ### Watch Tasks Retrieves task details when a task is created, edited, due, or completed. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Watch Tasks** | - **By Created Time** Retrieves created tasks.
- **By Modified Time** Retrieves edited tasks.
- **By Due Date Time** Retrieves tasks when a due date is changed.
- **By Completed Date Time** Retrieves tasks when the completed date is changed. | | **Filter** | Set the filter. Retrieved tasks can be filtered by the tasks subject (name). | | **List** | Select the list you want to monitor tasks from. | | **Limit** | Set the maximum number of tasks Make will return during one execution cycle. | ::: :::ExpandableHeading{isOpen="true"} ### Search Tasks Retrieves tasks by the filter settings. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **Filter** | Set the filter. Retrieved tasks can be filtered by the task's:
- **subject (name)**
- **created date**
- **last modified date** | | **List** | Select the list you want to monitor tasks from. | | **Order by** | Select the sort order of returned tasks. | | **Limit** | Set the maximum number of tasks Make will return during one execution cycle. | ::: :::ExpandableHeading{isOpen="true"} ### Search Overdue Tasks Retrieves overdue tasks by the filter settings. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **Filter** | Set the filter. Retrieved tasks can be filtered by the task's:
- **subject (name)**
- **created date**
- **last modified date** | | **List** | Select the list you want to monitor tasks from. | | **Order by** | Select the sort order of returned tasks. | | **Limit** | Set the maximum number of overdue tasks Make will return during one execution cycle. | ::: :::ExpandableHeading{isOpen="true"} ### Get a Task Retrieves task details. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to retrieve details about. | ::: :::ExpandableHeading{isOpen="true"} ### Create a Task Creates a new task. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Subject** | Enter the subject/name of the task. | | **Start Date Time** | Enter the date in the specified time zone when the task is to begin in the ISO 8601 format. E.g. `2020-04-16T09:00:00`. [The list of supported date and time formats](docId\:sQIttS_xZcFLFg9j6XYuI). | | **Due Date Time** | Enter the date in the specified time zone that the task is to be finished in the ISO 8601 format. E.g. `2020-04-16T09:00:00`. [The list of supported date and time formats](docId\:sQIttS_xZcFLFg9j6XYuI). | | **Reminder Date Time** | Enter the date and time for a reminder alert of the task to occur in the ISO 8601 format. E.g. `2020-04-16T09:00:00`. [The list of supported date and time formats](docId\:sQIttS_xZcFLFg9j6XYuI). | | **List ID** | Enter (map) or select the task's parent folder. | | **Importance** | Set the importance of the new task. | | **Note** | Enter the text content of the note for the task. | | **Categories** | Select the categories associated with the task. This is compatible only with the on-premise version. i.e. Outlook. | | **Source File** | Map the file to add the attachment to the task. Max size 3 MB.
Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually. | ::: :::ExpandableHeading{isOpen="true"} ### Update a Task Edits an existing task. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to update. | ::: :::ExpandableHeading{isOpen="true"} ### Delete a Task Deletes a specified task. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to delete. | ::: :::ExpandableHeading{isOpen="true"} ### Complete a Task Sets a task status to *completed*. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to complete. | ::: ## List :::ExpandableHeading{isOpen="true"} ### Search Lists Retrieves lists by the filter settings from your account. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Filter** | Set the filter. Retrieved lists can be filtered by the list's:
- **name** | | **Limit** | Set the maximum number of lists Make will return during one execution cycle. | ::: :::ExpandableHeading{isOpen="true"} ### Get a List Retrieve list details. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **List ID** | Enter (map) or select the list you want to retrieve details about. | ::: :::ExpandableHeading{isOpen="true"} ### Create a List Creates a new list. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **List Name** | Enter (map) or select the list you want to retrieve details about. | ::: :::ExpandableHeading{isOpen="true"} ### Update a List Edits an existing list's name. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **List ID** | Enter (map) or select the list whose name you want to update. | | **Name** | Enter the new name for the list. | ::: :::ExpandableHeading{isOpen="true"} ### Delete a List Deletes a specified list. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **List ID** | Enter (map) or select the list you want to delete. | ::: ## Attachment :::ExpandableHeading{isOpen="true"} ### List Attachments Retrieves a list of files attached to the task. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | -------------- | --------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to retrieve files from. | | **Limit** | Set the maximum number of files Make will return during one execution cycle. | ::: :::ExpandableHeading{isOpen="true"} ### Add an Attachments Adds a file to the task. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Task ID** | Enter (map) or select the task you want to attach the file to. | | **Source File** | Map the file to add the attachment to the task. Max size 3 MB.
Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually. | ::: ## Other :::ExpandableHeading{isOpen="true"} ### Make an API Call Allows you to perform a custom API call. | **Connection** | [Establish a connection to your Microsoft account.](docId\:nbRIWETV5FbZQoHTI1MLX) | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **URL** | Enter a path relative to `https://graph.microsoft.com`. e.g. `/beta/me/outlook/tasks` or `/v1.0/me/events`
For the list of available endpoints, refer to the Microsoft Graph REST API documentations: [Beta](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta) or [v1.0](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0) | | **Method** | Select the HTTP method you want to use:
**GET** to retrieve information for an entry.
**POST** to create a new entry.
**PUT** to update/replace an existing entry.
**PATCH** to make a partial entry update.
**DELETE** to delete an entry. | | **Headers** | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. | | **Query String** | Enter the request query string. | | **Body** | Enter the body content for your API call. | ::: :::ExpandableHeading{isOpen="true"} ### Example of Use - List Tasks The following API call returns all tasks in your Microsoft To Do account: **URL**: `/beta/me/outlook/tasks` **Method**: `GET` Results can be found in the module's **Output** under *Bundle* > *Body > value.* In our example, 4 tasks were returned: ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/x8gyAiAiiFtSkoPx09phN_uuid-8708bc09-f166-b120-7d99-2ecf27ffa9c7.png" size="58" width="316" height="437" position="center" showCaption="false"} :::