Skip to content
Agentic Workflowdocs
v0.8.2Install free

nodes / builtin / integration

Todoist

Create and manage Todoist tasks from the current page, with natural-language due dates.

Integration ExtensionWeb app — not available

Turn the page you are on into a Todoist task in one step, and create, update, complete or list tasks from a workflow.

workflow · selection-to-todoist.awf 4 steps

Selection to Todoist Task: a workflow with 4 steps, starting with Right-click a selection and ending with Create the Todoist task.

Open in AWFlow

The Todoist node works on three kinds of things (Resource):

  • Task: create a task, update it, close it (mark it complete), or list your open tasks.
  • Project: list your projects, to find a Project ID.
  • Label: list your labels.

Due (natural language) takes dates the way you type them in Todoist, like tomorrow 9am, next Monday or every Friday. When you fill Source URL on Task → Create, a Source: line with the link is added at the end of the description, so the task always points back to its page.

Without a Project ID, new tasks go to your Inbox, and Task → List returns open tasks from all projects.

  • Save the page you are reading as a “read later” or “follow up” task, with a hotkey.
  • Create a task with a due date when a form, an email or a page change needs action.
  • Mark a task complete when a workflow has done the work.
  • List today’s tasks and send them to an AI node or a chat.

For team issue tracking, use Linear or GitHub. For Microsoft To Do, use Microsoft 365.

For every choice
SettingTypeWhat it does
Credential (required)CredentialA Todoist personal API token (Settings → Integrations → Developer). It grants full access to your Todoist account — keep it secret.

6 choices · pick resource and operation to see its settings

Task
Project
Label

Settings for Task · Create

SettingTypeWhat it does
Content (required)TextThe task text (supports Markdown, e.g. a [link](url)).
Description TextA longer task description (Markdown supported).
Source URL TextThe page URL to attach — appended to the description when present.
Project ID TextThe project the task belongs to (use Project → List to find its ID).
Due (natural language) TextA human due date like "tomorrow 9am" or "every Friday".
Priority ChoiceTask priority (p1 is highest). Options: Priority 1 (urgent), Priority 2, Priority 3, Priority 4 (normal).
Labels ListLabel names to attach to the task.

Showing settings for Task · Create

  • Content is the task title. Markdown links work, for example [Read: {{ $input.title }}]({{ $input.url }}).
  • Priority 1 (urgent) is Todoist’s red p1; Priority 4 (normal) is the default with no flag.
  • Labels take label names as you see them in Todoist, one per entry.
  • Project ID and Task ID are ids, not names. Run Project → List or Task → List and copy the id.
  • Output
  • Task → Create and Update return the task, including its id, content, description, due, priority, labels and url (the link to open it in Todoist).
  • Task → Close returns an empty result when it worked.
  • Task → List, Project → List and Label → List return one item per task, project or label, each with its id and name.

Use your Todoist API token, saved as a Bearer Token credential. In Todoist, open Settings → Integrations → Developer and copy the API token. See Create a credential.

The token gives full access to your Todoist account. If it leaks, issue a new one on the same page and update the credential.

  1. A Hotkey trigger starts the workflow with a keyboard shortcut.
  2. Get Page Metadata reads the page’s title and url.
  3. Todoist, Task → Create, Content Read: {{ $input.title }}, Source URL {{ $input.url }}, Due (natural language) tomorrow 9am, Labels reading.
  4. Browser Notification confirms the task was added.
  • “Todoist API Error: 401 Unauthorized” or “403 Forbidden”. The token is wrong or was replaced. Copy the current token from Settings → Integrations → Developer and update the credential.
  • “Todoist API Error: 400 Bad Request…”. Usually a Project ID or Task ID that does not exist, or a due date Todoist cannot read. Check the id with a List operation, or try a simpler date like tomorrow.
  • “Todoist API Error: 404 Not Found” on Update or Close. The task does not exist or is already completed.
  • The task went to the Inbox. Project ID was empty. Copy the project’s id from Project → List.
  • The run is blocked in the web app. Todoist runs through the browser extension. Install the extension and allow Todoist for this workflow when asked, or run the workflow from the extension. See Running extension-only integrations in the web app.
Turn highlighted text into a Todoist task beginner · 6 min Needs a connection
  • Hotkey: capture the current page with a keyboard shortcut.
  • Get Page Metadata: the page’s title and address for the task.
  • Linear: issues for a team instead of personal tasks.
  • Trello: cards on a board.
Edit page

Last updated:

Was this page useful?
Ask Aria about Todoist