Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Todoist

To-do list and task manager

CategoryProductivity
AuthenticationOAuth 2.0
Version0.5.0
Published scopes1 published scope
Last updatedSeptember 21, 2026

Overview

Connect Todoist with Flows360

To-do list and task manager

Use the Todoist connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 47 actions and 1 trigger.

Available actions

  • Create Task
  • Update Task
  • Find Task
  • Mark Task as Completed
  • Create Task
  • Update Task
  • Find Task
  • Complete Task
  • Plus 39 additional declared actions.

Available triggers

  • Task Completed

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Todoist
  • Package: @activepieces/piece-todoist@0.5.0
  • Exact artifact digest: sha256:82b47e481e6e24d2e89c07c531d1d625da0cc4226292a1351ea3369b4e7d39f0
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Create Task (create_task), Create task Classification: read.
  • Update Task (update_task), Updates an existing task. Classification: read.
  • Find Task (find_task), Finds a task by name. Classification: read.
  • Mark Task as Completed (mark_task_completed), Marks a task as being completed. Classification: read.
  • Create Task (todoist_create_task), Create a task in Todoist with explicit, structured fields. Classification: read.
  • Update Task (todoist_update_task), Update fields on an existing Todoist task. Classification: read.
  • Find Task (todoist_find_task), Find an active task by its exact name. Classification: read.
  • Complete Task (todoist_complete_task), Mark an active task as completed. Classification: read.
  • Filter Tasks (todoist_filter_tasks), Query active tasks using Todoist filter syntax. Classification: read.
  • Delete Task (todoist_delete_task), Permanently delete a task. Classification: read.
  • Reopen Task (todoist_reopen_task), Uncomplete a previously completed task. Classification: read.
  • Move Task (todoist_move_task), Move a task to a different project, section, or parent. Classification: read.
  • Quick Add Task (todoist_quick_add_task), Create a task from a natural-language sentence. Classification: read.
  • Get Task (todoist_get_task), Fetch a single task by its ID. Classification: read.
  • List Completed Tasks (by Completion Date) (todoist_list_completed_tasks), List tasks completed within a date window. Classification: read.
  • List Completed Tasks (by Due Date) (todoist_list_completed_tasks_by_due_date), List completed tasks whose due date falls in a window. Classification: read.
  • Create Project (todoist_create_project), Create a new Todoist project. Classification: read.
  • Update Project (todoist_update_project), Update an existing Todoist project. Classification: read.
  • Get Project (todoist_get_project), Get a single Todoist project by its ID. Classification: read.
  • List Projects (todoist_list_projects), List all Todoist projects. Classification: read.
  • Search Projects (todoist_search_projects), Search Todoist projects by name. Classification: read.
  • Unarchive Project (todoist_unarchive_project), Restore an archived Todoist project to active. Classification: read.
  • List Archived Projects (todoist_list_archived_projects), List archived Todoist projects. Classification: read.
  • Create Section (todoist_create_section), Create a new section within a Todoist project. Classification: read.
  • Update Section (todoist_update_section), Rename an existing Todoist section. Classification: read.
  • Get Section (todoist_get_section), Get a single Todoist section by its ID. Classification: read.
  • Delete Section (todoist_delete_section), Delete a Todoist section and all tasks inside it. Classification: read.
  • List Sections (todoist_list_sections), List Todoist sections, optionally filtered to one project. Classification: read.
  • Search Sections (todoist_search_sections), Search Todoist sections by name. Classification: read.
  • List Archived Sections (todoist_list_archived_sections), List archived sections within a Todoist project. Classification: read.
  • Create Label (todoist_create_label), Creates a new personal label in Todoist. Classification: read.
  • Update Label (todoist_update_label), Updates an existing personal label in Todoist. Classification: read.
  • Get Label (todoist_get_label), Gets a single personal label by ID in Todoist. Classification: read.
  • Delete Label (todoist_delete_label), Deletes a personal label in Todoist. Classification: read.
  • List Labels (todoist_list_labels), Lists all of the user's personal labels in Todoist. Classification: read.
  • Search Labels (todoist_search_labels), Searches personal labels by name in Todoist. Classification: read.
  • List Shared Labels (todoist_list_shared_labels), Lists shared (workspace) label names in Todoist. Classification: read.
  • Rename Shared Label (todoist_rename_shared_label), Renames a shared (workspace) label across all tasks in Todoist. Classification: read.
  • Remove Shared Label (todoist_remove_shared_label), Removes a shared (workspace) label from all tasks in Todoist. Classification: read.
  • Create Task Comment (todoist_create_task_comment), Adds a comment to a Todoist task. Classification: read.
  • Create Project Comment (todoist_create_project_comment), Adds a comment to a Todoist project. Classification: read.
  • Get Comment (todoist_get_comment), Fetches a single Todoist comment by its ID. Classification: read.
  • List Comments (todoist_list_comments), Lists all comments on a Todoist task or project. Classification: read.
  • Get Current User (todoist_get_current_user), Retrieves the authenticated Todoist user profile. Classification: read.
  • Get Productivity Stats (todoist_get_productivity_stats), Retrieves the authenticated user's Todoist productivity statistics. Classification: read.
  • List Activity Log (todoist_list_activity_log), Retrieves the Todoist activity (event) history. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Task Completed, polling.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

AuthenticationOAuth 2.0
Supported objects48
Supported actionsNot published
Triggers1

Authentication

Authentication method: OAuth 2.0

Required scopes

data:read_write

Authentication profiles

connection · oauth2

OAuth scopes: data:read_write

Supported objects

ObjectReadWriteNotes
Create Task Yes No Create task
Update Task Yes No Updates an existing task.
Find Task Yes No Finds a task by name.
Mark Task as Completed Yes No Marks a task as being completed.
Create Task Yes No Create a task in Todoist with explicit, structured fields.
Update Task Yes No Update fields on an existing Todoist task.
Find Task Yes No Find an active task by its exact name.
Complete Task Yes No Mark an active task as completed.
Filter Tasks Yes No Query active tasks using Todoist filter syntax.
Delete Task Yes No Permanently delete a task.
Reopen Task Yes No Uncomplete a previously completed task.
Move Task Yes No Move a task to a different project, section, or parent.
Quick Add Task Yes No Create a task from a natural-language sentence.
Get Task Yes No Fetch a single task by its ID.
List Completed Tasks (by Completion Date) Yes No List tasks completed within a date window.
List Completed Tasks (by Due Date) Yes No List completed tasks whose due date falls in a window.
Create Project Yes No Create a new Todoist project.
Update Project Yes No Update an existing Todoist project.
Get Project Yes No Get a single Todoist project by its ID.
List Projects Yes No List all Todoist projects.
Search Projects Yes No Search Todoist projects by name.
Unarchive Project Yes No Restore an archived Todoist project to active.
List Archived Projects Yes No List archived Todoist projects.
Create Section Yes No Create a new section within a Todoist project.
Update Section Yes No Rename an existing Todoist section.
Get Section Yes No Get a single Todoist section by its ID.
Delete Section Yes No Delete a Todoist section and all tasks inside it.
List Sections Yes No List Todoist sections, optionally filtered to one project.
Search Sections Yes No Search Todoist sections by name.
List Archived Sections Yes No List archived sections within a Todoist project.
Create Label Yes No Creates a new personal label in Todoist.
Update Label Yes No Updates an existing personal label in Todoist.
Get Label Yes No Gets a single personal label by ID in Todoist.
Delete Label Yes No Deletes a personal label in Todoist.
List Labels Yes No Lists all of the user's personal labels in Todoist.
Search Labels Yes No Searches personal labels by name in Todoist.
List Shared Labels Yes No Lists shared (workspace) label names in Todoist.
Rename Shared Label Yes No Renames a shared (workspace) label across all tasks in Todoist.
Remove Shared Label Yes No Removes a shared (workspace) label from all tasks in Todoist.
Create Task Comment Yes No Adds a comment to a Todoist task.
Create Project Comment Yes No Adds a comment to a Todoist project.
Get Comment Yes No Fetches a single Todoist comment by its ID.
List Comments Yes No Lists all comments on a Todoist task or project.
Get Current User Yes No Retrieves the authenticated Todoist user profile.
Get Productivity Stats Yes No Retrieves the authenticated user's Todoist productivity statistics.
List Activity Log Yes No Retrieves the Todoist activity (event) history.
Custom API Call Yes No Make a custom API call to a specific endpoint
Task Completed Yes No polling trigger declared by the pinned package.

Triggers

Task Completed · Poll

Triggers when a new task is completed

Inputs

  • project_id · string

Setup

Setup

  1. Add the Todoist connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.

OAuth scopes

  • data:read_write
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-todoist@0.5.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 47 actions and 1 trigger declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Todoist connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-todoist@0.5.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com