Create Task List

ms_todo.create_task_list

ActionBusiness appsconnection required

Calls the Microsoft To Do API with the connection's credentials.

Create a new To Do task list for the connected user.

Ask about Microsoft To Do All Microsoft To Do nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: OAuth 2.0
Providers: Microsoft To Do
Secret shape: {"client_id": "…", "client_secret": "…", "refresh_token": "…"} with the Tasks.ReadWrite delegated scope
Config it needs: tenant
Resolved by: config.connection_id, else node.connection_id

Configuration

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
display_name Name for the new list, as it appears in To Do.	string	Yes	—	—	—

Output

One shape.

result

Field	Type	Example
id The task list id to use in later steps.	string	—
display_name The list's name as shown in To Do.	string	—
is_owner True when the connected user owns the list.	boolean	—
is_shared True when the list is shared with other people.	boolean	—
well_known_name 'defaultList' for the built-in Tasks list, else empty.	string	—

{
  "display_name": "",
  "id": "",
  "is_owner": false,
  "is_shared": false,
  "well_known_name": ""
}

Related Microsoft To Do nodes

See Create Task List run in a workflow.

In a technical demo we add the Microsoft To Do connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales