How to use IBM 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.
- App Connect Enterprise as a Service connector
-
Local
connector in containers (Continuous Delivery release) 12.0.9.0-r2 or later -
Local connector in containers (Long Term Support Cycle-2 release)
Connecting to Microsoft To Do
Complete the connection fields that you see in the App Connect Designer page (previously the Catalog page) or flow editor. If necessary, work with your Microsoft To Do administrator to obtain these values.
| Authorization method | Connection field | Applicability |
|---|---|---|
| BASIC OAUTH | Application client ID | App Connect Enterprise as a Service and App Connect in containers |
| Application client secret | ||
| Access token | ||
| Refresh token | ||
| OAUTH 2.0 PASSWORD | Username | App Connect Enterprise as a Service and App Connect in containers |
| Password | ||
| Application client ID | ||
| Application client secret | ||
| OAUTH 2.0 AUTH CODE |
Tip: Authorize connection to Microsoft
To Do by signing in
to your account.
|
App Connect Enterprise as a Service |
| 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.
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.
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
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, open the Templates gallery, and then search for Microsoft To Do.
Use IBM® App Connect to build flows that integrate with Microsoft To Do.
Read the blog in the IBM Community to learn how to create a task on the Microsoft To Do list using information retrieved from Microsoft Excel Online. Click Read the blog to go to the blog.