Microsoft To Do
Microsoft To Do is a cloud-based task management application that helps users organize, prioritize, and track tasks across devices with features like lists, reminders, and collaboration.
Categories: Productivity and Collaboration
Type: microsoftToDo/v1
Connections
Version: 1
OAuth2 Authorization Code
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| clientId | Client Id | STRING | true | |
| clientSecret | Client Secret | STRING | true | |
| tenantId | Tenant Id | STRING | true |
Connection Setup
Create OAuth 2.0 Application
Creation of OAuth 2.0 application is documented here.
Grant Necessary Permissions
- Open the Azure Portal: https://portal.azure.com/
- Click on App registrations.
- Click on All applications.
- Click on application you want to connect to Microsoft To Do.
- Click on API permissions.
- Click on Microsoft Graph (1).
- Select following scopes:
- Tasks.ReadWrite
- offline_access
- After selecting all the scopes click on Update permissions
Actions
Create Task
Name: createTask
Creates a new task.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| taskListId | Task List ID | STRING | ID of the task list where the task will be created. | true |
| title | Title | STRING | Title of the task. | true |
| importance | Importance | STRING Optionslow, normal, high | Importance of the task. | false |
| isReminderOn | Reminder | BOOLEAN Optionstrue, false | Set to true if an alert is set to remind the user of the task. | false |
Example JSON Structure
{
"label" : "Create Task",
"name" : "createTask",
"parameters" : {
"taskListId" : "",
"title" : "",
"importance" : "",
"isReminderOn" : false
},
"type" : "microsoftToDo/v1/createTask"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| @odata.etag | STRING | |
| importance | STRING | Importance of the task. |
| isReminderOn | BOOLEAN Optionstrue, false | Indicates whether an alert is set to reminder the user of the task. |
| status | STRING | State or progress of the task. |
| title | STRING | Title of the task. |
| categories | STRING | The categories associated with the task. |
| id | STRING | ID of the task. |
| body | OBJECT Properties{STRING(content), STRING(contentType)} | Body of the task containing information about the task. |
| linkedResources | OBJECT Properties{STRING(id), STRING(webUrl), STRING(applicationName), STRING(displayName)} |
Output Example
{
"@odata.etag" : "",
"importance" : "",
"isReminderOn" : false,
"status" : "",
"title" : "",
"categories" : "",
"id" : "",
"body" : {
"content" : "",
"contentType" : ""
},
"linkedResources" : {
"id" : "",
"webUrl" : "",
"applicationName" : "",
"displayName" : ""
}
}Create Task List
Name: createTaskList
Creates a new task list.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| displayName | Title | STRING | Title of the task list. | true |
Example JSON Structure
{
"label" : "Create Task List",
"name" : "createTaskList",
"parameters" : {
"displayName" : ""
},
"type" : "microsoftToDo/v1/createTaskList"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| @odata.context | STRING | |
| @odata.etag | STRING | |
| id | STRING | ID of the task list. |
| displayName | STRING | The name of the task list. |
| isOwner | BOOLEAN Optionstrue, false | Indicates whether the user is the owner of the task list. |
| isShared | BOOLEAN Optionstrue, false | Indicates whether the task list is shared with other users. |
| wellKnownListName | STRING | Property indicating the list name if the given list is a well-known list. The possible values are: none, defaultList, flaggedEmails, unknownFutureValue. |
Output Example
{
"@odata.context" : "",
"@odata.etag" : "",
"id" : "",
"displayName" : "",
"isOwner" : false,
"isShared" : false,
"wellKnownListName" : ""
}Delete Task
Name: deleteTask
Deletes a task by ID.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| taskListId | Task List ID | STRING | ID of the task list where the task is located. | true |
| taskId | Task ID | STRING Depends OntaskListId | ID of the task to delete. | true |
Example JSON Structure
{
"label" : "Delete Task",
"name" : "deleteTask",
"parameters" : {
"taskListId" : "",
"taskId" : ""
},
"type" : "microsoftToDo/v1/deleteTask"
}Output
This action does not produce any output.
Get Task
Name: getTask
Gets task by ID.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| taskListId | Task List ID | STRING | ID of the task list where the task is located. | true |
| taskId | Task ID | STRING Depends OntaskListId | ID of the task to retrieve. | true |
Example JSON Structure
{
"label" : "Get Task",
"name" : "getTask",
"parameters" : {
"taskListId" : "",
"taskId" : ""
},
"type" : "microsoftToDo/v1/getTask"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| @odata.etag | STRING | |
| importance | STRING | Importance of the task. |
| isReminderOn | BOOLEAN Optionstrue, false | Indicates whether an alert is set to reminder the user of the task. |
| status | STRING | State or progress of the task. |
| title | STRING | Title of the task. |
| categories | STRING | The categories associated with the task. |
| id | STRING | ID of the task. |
| body | OBJECT Properties{STRING(content), STRING(contentType)} | Body of the task containing information about the task. |
| linkedResources | OBJECT Properties{STRING(id), STRING(webUrl), STRING(applicationName), STRING(displayName)} |
Output Example
{
"@odata.etag" : "",
"importance" : "",
"isReminderOn" : false,
"status" : "",
"title" : "",
"categories" : "",
"id" : "",
"body" : {
"content" : "",
"contentType" : ""
},
"linkedResources" : {
"id" : "",
"webUrl" : "",
"applicationName" : "",
"displayName" : ""
}
}Triggers
New Task
Name: newTask
Triggers when a new task is created in a specified task list.
Type: POLLING
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| taskListId | Task List ID | STRING | ID of the task list to monitor for new tasks. | true |
Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| @odata.etag | STRING | |
| importance | STRING | Importance of the task. |
| isReminderOn | BOOLEAN Optionstrue, false | Indicates whether an alert is set to reminder the user of the task. |
| status | STRING | State or progress of the task. |
| title | STRING | Title of the task. |
| categories | STRING | The categories associated with the task. |
| id | STRING | ID of the task. |
| body | OBJECT Properties{STRING(content), STRING(contentType)} | Body of the task containing information about the task. |
| linkedResources | OBJECT Properties{STRING(id), STRING(webUrl), STRING(applicationName), STRING(displayName)} |
JSON Example
{
"label" : "New Task",
"name" : "newTask",
"parameters" : {
"taskListId" : ""
},
"type" : "microsoftToDo/v1/newTask"
}What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
How is this guide?
Last updated on