Skip to main content

Flow Cards

The Todoist app provides flow cards to automate your task management through Homey. These include trigger cards (When...), condition cards (And...), and action cards (Then...).

Triggers (When...)​

Trigger cards start a flow when a specific event occurs.

A task was...​

Triggers when a task is completed or uncompleted in Todoist. Events are delivered via webhooks and may have a slight delay of 0 to 30 seconds.

Todoist
A task was Event
i
Events might have slight delays (0-30sec).

Tokens provided:

TokenTypeDescription
ContentStringThe text content of the task that was completed or uncompleted.

Tasks are fetched for project...​

Triggers when tasks have been fetched for a specific project using the "Fetch project tasks" action card. Use this to process the fetched task list in your flow.

Todoist
Tasks for Project are fetched
i
Use a Then card to fetch tasks for a project.

Tokens provided:

TokenTypeDescription
TasksStringA formatted list of all tasks in the project, including due dates where applicable.

Conditions (And...)​

Condition cards check whether a specific requirement is met before continuing the flow.

Task with filter exists...​

Checks whether any task matching the given filter text exists. You can optionally restrict the search to a specific project.

Todoist
Task with Filter !{{exists|does not exist}} in Project
i
Checks if any task with the filter exists. There might be multiple tasks that match.
tip

Use a specific filter to avoid false positives. The filter searches task content text. If no project is selected, all projects are searched.

Actions (Then...)​

Action cards perform tasks when a flow runs.

Create a project task​

Creates a new task in the selected Todoist project with an optional priority and assignee.

Todoist
Create a task Do the laundry in Project with priority Priority and assign to Assignee
i
Creates a task in the selected project.

Create a project task with a due text​

Creates a task with a natural-language due date string (e.g., "in 1 hour", "tomorrow at 3pm"). The due text interpretation is based on your Todoist language and timezone settings.

Todoist
Create a task Do the laundry in Project and due Due with priority Priority and assign to Assignee
i
Creates a task in the selected project with a due text (e.g. in 1 hour). The due text is based on the Todoist language/timezone setting. For all posibilities refer to the Todoist help articles.
info

The due text supports Todoist's natural language parsing. Examples include:

  • tomorrow
  • next Monday
  • in 2 hours
  • every day at 9am
  • 21-05-2025 20:20

For the full list of supported formats, refer to the Todoist help articles.

Create a project task with a due date​

Creates a task with a specific due date using a date picker.

Todoist
Create a task Do the laundry in Project and due date Due date with priority Priority and assign to Assignee
i
Creates a task in the selected project with a due date.

Create a project task with a due date and time​

Creates a task with both a specific due date and time. The time is adjusted for your Homey's timezone.

Todoist
Create a task Do the laundry in Project and due date Due date and due time Due time with priority Priority and assign to Assignee
i
Creates a task in the selected project with a due date and a due time.

Fetch project tasks​

Fetches all tasks for a given project and triggers any "Tasks are fetched for project..." When cards that are listening for the same project.

Todoist
Fetch tasks for Project
i
Fetch the tasks for a project. This card attempts to start When cards that are listening to a fetch event for the same project.
tip

Combine this action card with the "Tasks are fetched for project" trigger card to create flows that process task lists. For example, you could fetch tasks on a schedule and send the list as a notification.

Complete tasks with filter​

Completes all tasks matching the given filter text. You can optionally restrict the search to a specific project.

Todoist
Complete tasks with Filter in Project
i
A filter that is not very specific has the potential the complete alot of tasks. Make sure you have a very specific filter.
warning

Be careful with broad filters! A non-specific filter can match and complete many tasks at once. Always use a very specific filter to avoid accidentally completing tasks you didn't intend to.

How to Use Flow Cards​

  1. In the Homey app, go to Flows.
  2. Either edit an existing Flow or create a new Flow:
    • Mobile App: Tap the + icon in the top-right corner, then select New Flow.
    • Web App: Click New Flow to start a new flow (basic or advanced).
  3. In the flow editor:
    • For triggers: Go to When and search for your Todoist User device.
    • For conditions: Go to And and search for your Todoist User device.
    • For actions: Go to Then and search for your Todoist User device.
  4. Select the desired flow card and configure the parameters.
  5. Combine with other triggers, conditions, or actions to build your automation.

Example: Daily Task Reminder​

  1. When: Every day at 8:00 AM (using a time trigger)
  2. Then: Fetch tasks for your "Shopping" project
  3. When: Tasks for "Shopping" are fetched
  4. Then: Send a push notification with the tasks token

Example: Auto-Create Task When Washing Machine Finishes​

  1. When: The washing machine signals it has finished
  2. Then: Create a task "Hang up the laundry" in your "Household" project with due "in 1 hour"