Microsoft To Do

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 Integromat, 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.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Microsoft To Do to Integromat

To connect your Microsoft To Do account to Integromat follow the general instructions for Connecting to services.

After you click the Continue button, Integromat will redirect you to the Microsoft To Do website where you will be prompted to grant Integromat access to your account.

Confirm the dialog by clicking the Yes button.

Task

Watch Tasks

Retrieves task details when a task is created, edited, due, or completed.

Connection	Establish a connection to your Microsoft account.
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 Integromat will return during one execution cycle.

Search Tasks

Retrieves tasks by the filter settings.

Connection	Establish a connection to your Microsoft account.
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 Integromat will return during one execution cycle.

Search Overdue Tasks

Retrieves overdue tasks by the filter settings.

Connection	Establish a connection to your Microsoft account.
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 Integromat will return during one execution cycle.

Get a Task

Retrieves task details.

Connection	Establish a connection to your Microsoft account.
Task ID	Enter (map) or select the task you want to retrieve details about.

Create a Task

Creates a new task.

Connection	Establish a connection to your Microsoft account.
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.
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.
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.
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.

Update a Task

Edits an existing task.

Connection	Establish a connection to your Microsoft account.
Task ID	Enter (map) or select the task you want to update.

Please find the descriptions of the fields in the Create a Task section above.

Delete a Task

Deletes a specified task.

Connection	Establish a connection to your Microsoft account.
Task ID	Enter (map) or select the task you want to delete.

Complete a Task

Sets a task status to completed.

Connection	Establish a connection to your Microsoft account.
Task ID	Enter (map) or select the task you want to complete.

List

Search Lists

Retrieves lists by the filter settings from your account.

Connection

Establish a connection to your Microsoft account.

Filter

Set the filter. Retrieved lists can be filtered by the list's:

name

Limit

Set the maximum number of lists Integromat will return during one execution cycle.

Get a List

Retrieve list details.

Connection	Establish a connection to your Microsoft account.
List ID	Enter (map) or select the list you want to retrieve details about.

Create a List

Creates a new list.

Connection	Establish a connection to your Microsoft account.
List Name	Enter (map) or select the list you want to retrieve details about.

Update a List

Edits an existing list's name.

Connection	Establish a connection to your Microsoft account.
List ID	Enter (map) or select the list whose name you want to update.
Name	Enter the new name for the list.

Delete a List

Deletes a specified list.

Connection	Establish a connection to your Microsoft account.
List ID	Enter (map) or select the list you want to delete.

Attachment

List Attachments

Retrieves a list of files attached to the task.

Connection	Establish a connection to your Microsoft account.
Task ID	Enter (map) or select the task you want to retrieve files from.
Limit	Set the maximum number of files Integromat will return during one execution cycle.

Add an Attachment

Adds a file to the task.

Connection

Establish a connection to your Microsoft account.

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

Make an API Call

Allows you to perform a custom API call.

Connection	Establish a connection to your Microsoft account.
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 or v1.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.