How to use App Connect with Microsoft To Do

Microsoft To Do is a task management application that helps you manage daily tasks and remain organized. To-do tasks are grouped in task lists, which can be viewed from any device by using To-Do clients, Outlook, and Teams.

Connecting to Microsoft To Do

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page (previously the Catalog page) or flow editor. If necessary, work with your Microsoft To Do administrator to obtain these values.

Microsoft To Do has the following connection fields.

Authorization method	Connection field	Applicability
BASIC OAUTH	Application client ID	App Connect and App Connect in containers
	Application client secret
	Access token
	Refresh token
OAUTH 2.0 PASSWORD	Username	App Connect and App Connect in containers
	Password
	Application client ID
	Application client secret
OAUTH 2.0 AUTH CODE	Tip: Authorize a connection to Microsoft To Do by signing in to your account.	App Connect

The following table describes the connection fields.

Connection field	Description
Application client ID	The unique identifier generated after the Microsoft Azure app registration gets mapped to the specific project requests.
Application client secret	The application client secret for a project-specific unique application client ID.
Access token	The access token that is generated from the application client ID and client secret.
Refresh token	The refresh token that is generated from the application client ID and client secret.
Username	The username that is authorized to access the Microsoft To Do API.
Password	The password for the specified username.

To obtain the connection values for Microsoft To Do, see Obtaining connection values for Microsoft To Do.

To connect to a Microsoft To Do endpoint from the App Connect Designer Applications and APIs page for the first time, expand Microsoft To Do, then click Connect. For more information, see Managing accounts.

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

General considerations

Before you use App Connect Designer with Microsoft To Do, take note of the following considerations:

(General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.
For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
(General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

Microsoft To Do events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Note: Events are not available for changes in this application. You can trigger a flow in other ways, such as at a scheduled interval or at specific dates and times.

Microsoft To Do actions

Your flow completes these actions on this application.

Object	Action	Description
Lists	Create list	Creates a list in Microsoft To Do
	Retrieve lists	Retrieves the lists in Microsoft To Do
	Retrieve list by ID	Retrieves the list by ID in Microsoft To Do
	Delete list	Deletes the list in Microsoft To Do
	Update list	Updates the list in Microsoft To Do
Tasks	Create task	Creates a task in Microsoft To Do
	Retrieve tasks	Retrieves the tasks in Microsoft To Do
	Retrieve task by ID	Retrieves the task by ID in Microsoft To Do
	Update task	Update the task by ID in Microsoft To Do
	Delete task	Deletes the task in Microsoft To Do
Checklist items	Create checklist item	Creates the checklist item in Microsoft To Do
	Retrieve checklist item by ID	Retrieves the checklist item by ID in Microsoft To Do
	Update checklist item	Updates the checklist item in Microsoft To Do
	Delete checklist item	Deletes the checklist item in Microsoft To Do
File attachments	Retrieve file attachment by ID	Retrieves the file attachment by ID in Microsoft To Do
	Delete file attachment	Deletes the file attachment in Microsoft To Do
	Create file attachment	Creates the file attachment in Microsoft To Do

Examples

Dashboard tile for a template that uses Microsoft To Do

Use templates to quickly create flows for Microsoft To Do

Learn how to use App Connect templates to quickly create flows that complete actions on Microsoft To Do. For example, go to the Discover page and search for Microsoft To Do.

Learn more

Use App Connect to build flows that integrate with Microsoft To Do.

The following blog post describes how to create a task on the Microsoft To Do list by using information that is retrieved from Microsoft Excel Online. Click Read the blog to go to the blog.

Read the blog