Microsoft To Do

12 min

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.

Connect Microsoft To Do to Make

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

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

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 Make will return during one execution cycle.

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 Make will return during one execution cycle.

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 Make will return during one execution cycle.

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.

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 formatsThe 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 formatsThe 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 formatsThe 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.

Edits an existing task.

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

Deletes a specified task.

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

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

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 Make will return during one execution cycle.

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.

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.

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.

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

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 Make will return during one execution cycle.

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

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.

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:

Microsoft To Do

Getting Started with Microsoft To Do

Connect Microsoft To Do to Make

Task

Watch Tasks

Search Tasks

Search Overdue Tasks

Get a Task

Create a Task

Update a Task

Delete a Task

Complete a Task

List

Search Lists

Get a List

Create a List

Update a List

Delete a List

Attachment

List Attachments

Add an Attachments

Other

Make an API Call

Example of Use - List Tasks