List Task Lists

ms_todo.list_task_lists

ActionBusiness appsconnection required

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

List the connected user's To Do task lists, following Graph paging.

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, none 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
max_results How many task lists to return at most; Graph pages are followed until this many.	number	No	50	1–1000	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "max_results": 50
}

Output

One shape.

result

Field	Type	Example
items The task lists found.	array	—
count How many task lists were returned.	number	—

{
  "count": 0,
  "items": []
}

Related Microsoft To Do nodes

See List Task Lists 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