Todoist

Manage Todoist tasks, projects, sections, labels, and comments from your flows, with natural-language due dates. Agents capture actionable messages as tasks and confirm before assigning work to a teammate.

26 actions available

An actionable email or message arrives, captured upstream

Agent reads the sender, subject, and the request in the body

Agent confirms the message actually needs a follow-up task

Agent decides the project, priority, and due date from the request

Agent creates the task with a natural-language due date and labels

Agent records the source message in the task so context is preserved

A task that should be assigned to a teammate is routed for a person to confirm

What This Integration Enables

FlowRunner agents use Todoist to capture and route work as decisions, not manual entry. An agent can create a task from an email, form, or message, setting a natural-language due date like "tomorrow at 5pm" or "every Monday" and a friendly priority. It can move tasks between projects and sections, manage labels, and post or read comments as a workflow progresses. On shared projects it reads collaborators so it can assign the right person. The routine capture runs on its own. The task that needs a human to own it, or a comment that needs a person to answer, is where the agent stops to ask.

Without FlowRunner

Inbox as task list Actionable requests live in an inbox until someone copies them out by hand

Missed follow-ups Requests slip because no task was ever created

Inconsistent due dates Deadlines get set from memory or not at all

With FlowRunner

Requests become tasks Actionable messages are turned into Todoist tasks the moment they arrive

Nothing slips Every request that needs follow-up gets a task with a due date

Consistent scheduling Due dates are set the same way, using natural language the agent parses

Use Case Scenarios

Email to Follow-Up Task

An actionable email arrives. The agent reads it, decides the project and priority, and creates a task with Create Task, setting a natural-language Due String so the follow-up is scheduled. It records the sender and subject in the task so the context travels with it. The inbox stops doubling as a task list.

Project-Plan Import

A project plan lives in a spreadsheet. The agent reads each row and calls Create Task for each item, placing tasks in the right project and section with labels applied. Because the agent parses due dates from the plan's own language, the imported tasks land already scheduled.

Shared-Project Assignment with a Human Gate

A request comes in that belongs to a teammate on a shared project. The agent drafts the task, reads the project's collaborators, and picks the likely owner. Before it assigns the task to a specific person, it confirms the assignment with a lead so no one is handed work without a human in the loop.

Human-in-Loop Highlight

When an agent creates a task on a shared project and needs to assign it to a specific teammate, it does not just hand the work over. Assigning a person work is a call that should have a human behind it. The agent pauses and routes to the project lead through their preferred channel: "This request looks like it belongs to [collaborator] on [project]. Assign the task to them, pick someone else, or leave it unassigned?" The lead decides, and the agent runs Update Task to set the assignee from there. The capture and scheduling run on their own; handing a person work reaches a person first.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

26 actions

Tasks

Create Task Creates a task with content, project, section, labels, priority, and a due date given as natural language or a fixed date. Used to turn a message or row into scheduled work.
Get Task Retrieves a single active task with its content, project, labels, priority, and due date. Used to read current state before acting.
List Tasks Lists active tasks, filtered by project, section, label, or a Todoist filter query like "today | overdue". Used to find the tasks a workflow should process.
Update Task Updates a task's content, labels, priority, due date, or assignee. Only the fields provided are changed. Used to reschedule, reclassify, or assign a task.
Close Task Completes a task, advancing recurring tasks to their next occurrence. Used to mark work done.
Reopen Task Reopens a completed task and restores it to active. Used to reverse a premature close.
Delete Task Permanently deletes a task and its subtasks. Used in cleanup.
Move Task Moves a task to a different project or section, or nests it under a parent task. Used to reorganize work.

Projects

Create Project Creates a project with a color, optional parent, favorite flag, and default view. Used to provision project structure on demand.
List Projects Lists the user's projects, paged via a cursor. Used to resolve which project to file work in.
Get Project Retrieves a single project with its color, view style, and favorite status. Used to inspect a project.
Update Project Updates a project's name, color, favorite status, or view style. Used to keep project settings in sync.
Delete Project Permanently deletes a project with its sections and tasks. Used in cleanup.
Get Collaborators Lists the collaborators on a shared project with their user IDs, names, and emails. Used to resolve who a task can be assigned to.

Sections

Create Section Creates a section within a project. Used to structure a project into stages.
List Sections Lists sections, optionally restricted to one project. Used to find where a task should live.
Delete Section Permanently deletes a section and its tasks. Used in cleanup.

Labels

Create Label Creates a personal label with a color and ordering. Used to build the labels a routing scheme depends on.
List Labels Lists the user's personal labels. Used to resolve which labels are available.
Update Label Renames or recolors a label, updating it on every task that carries it. Used to maintain a label scheme.
Delete Label Permanently deletes a label and removes it from all tasks. Used in cleanup.

Comments

Create Comment Adds a comment to a task or a project. Used by agents to log a note or ask a question.
List Comments Lists comments on a task or project. Used to read the discussion before acting.
Get Comment Retrieves a single comment with its content and author. Used to inspect a specific note.
Update Comment Updates the content of an existing comment. Used to correct or extend a note.
Delete Comment Permanently deletes a comment. Used in cleanup.

Start building with Todoist

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us