Todoist

Task manager: tasks, projects, sections, labels, and completion events

Todoist API referenceAPI checked August 18, 2026

Signs in with: API token
Runs on: Cloud or On-Prem Worker
Operations: 105
Ready-made triggers: 0

Connect Todoist

In Neblex open Connect › Connections and click New Connection.
Search for Todoist and give the connection a clear name.
Fill in the fields. Secret values are encrypted and never shown again.
Click Test, then Create Connection.

Field	What to enter
API tokenRequiredSecret	Todoist personal API token or OAuth access token. Stored sealed and sent only as Authorization: Bearer.

Use it in a flow

Open a flow, open the node library and search for Todoist.
Drag it onto the canvas and choose an Operation and your connection.
Map the operation's fields from earlier steps, or click Map with Matt.
Use Test this step to see what it returns, then save.

To start a flow from Todoist without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Todoist can send webhooks, a Webhook trigger receives them at its own URL.

Operations

105 operations in 20 groups. Each one is a step you can add to a flow.

Activity1

Get Activity Logsget_activity_logs_api_v1_activities_get GET Get activity logs.

Backups2

Download Backup`download_backup_api_v1_backups_download_get`	GET	Download a backup archive.
Get Backups`get_backups_api_v1_backups_get`	GET	Todoist creates a backup archive of users' data on a daily basis.

Billing7

Cancel Plan With Redirect To Stripe`cancel_plan_with_redirect_to_stripe_api_v1_payments_cancel_plan_with_redirect_to_stripe_post`	POST	Start a hosted cancellation flow and return the redirect URL.
Get Subscription Info`get_subscription_info_api_v1_payments_get_subscription_info_post`	POST	Return the current user's subscription state.
Reactivate Plan`reactivate_plan_api_v1_payments_reactivate_plan_post`	POST	Reactivate a previously canceled subscription.
Usage Billing History`usage_billing_history_api_v1_usage_billing_history_get`	GET	List the caller's usage-billing ledger entries, newest first.
Usage Billing State`usage_billing_state_api_v1_usage_billing_state_get`	GET	Read the caller's usage-billing credit state for a product.
Usage Billing Top Up`usage_billing_top_up_api_v1_usage_billing_top_up_post`	POST	In V1, create a hosted Stripe Checkout session to top up the authenticated user's personal Automations wallet.
Usage Billing Usage Summary`usage_billing_usage_summary_api_v1_usage_billing_usage_summary_get`	GET	Total the caller's settled usage over a window.

Collaborator1

Get Project CollaboratorslistCollaborators GET Get all collaborators for a given project.

Comment5

Create Comment`createComment`	POST	Creates a new comment on a project or task and returns it.
Delete Comment`deleteComment`	DELETE	Delete a comment by ID
Get Comment`getComment`	GET	Returns a single comment by ID
Get Comments`listComments`	GET	Get all comments for a given task or project.
Update Comment`updateComment`	POST	Update a comment by ID and returns its content

Emails2

Email Disable`email_disable_api_v1_emails_delete`	DELETE	Disable the current email to a Todoist object
Email Get Or Create`email_get_or_create_api_v1_emails_put`	PUT	Get or create an email to a Todoist object, currently only projects and tasks are supported.

Folders5

Create Folder`create_folder_api_v1_folders_post`	POST	Create a new folder in the given workspace.
Delete Folder`delete_folder_api_v1_folders__folder_id__delete`	DELETE	Delete a folder.
Get Folder`get_folder_api_v1_folders__folder_id__get`	GET	Return the folder for the given folder ID.
Get Folders`get_folders_api_v1_folders_get`	GET	Get all folders for a workspace.
Update Folder`update_folder_api_v1_folders__folder_id__post`	POST	Update an existing folder.

Ids1

Id Mappingsid_mappings_api_v1_id_mappings__obj_name___obj_ids__get GET Translates IDs from v1 to v2 or vice versa.

Label9

Create Label`createLabel`	POST	Create a personal label.
Delete Label`deleteLabel`	DELETE	Deletes a personal label.
Get Label`getLabel`	GET	Return a personal label by ID.
Get Labels`listLabels`	GET	Get all user labels.
Search Labels`searchLabels`	GET	Search user labels by name.
Shared Labels`listSharedLabels`	GET	Returns a set of unique strings containing shared labels from active tasks.
Shared Labels Remove`removeSharedLabel`	POST	Remove the given shared label from all active tasks
Shared Labels Rename`renameSharedLabel`	POST	Rename the given shared label from all active tasks
Update Label`updateLabel`	POST	Update a personal label.

Location reminders5

Create Location Reminder`create_location_reminder_api_v1_location_reminders_post`	POST	Create a new location reminder for a task.
Delete Location Reminder`delete_location_reminder_api_v1_location_reminders__reminder_id__delete`	DELETE	Delete a location reminder by ID.
Get Location Reminder`get_location_reminder_api_v1_location_reminders__reminder_id__get`	GET	Return a single location reminder by ID.
Get Location Reminders`get_location_reminders_api_v1_location_reminders_get`	GET	Get all active location reminders.
Update Location Reminder`update_location_reminder_api_v1_location_reminders__reminder_id__post`	POST	Update an existing location reminder.

Project10

Archive Project`archiveProject`	POST	Marks a project as archived.
Create Project`createProject`	POST	Creates a new project and returns it
Delete Project`deleteProject`	DELETE	Deletes a project and all of its sections and tasks.
Get Archived`listArchivedProjects`	GET	Get the user's archived projects.
Get Project`getProject`	GET	Returns a project object related to the given ID
Get Projects`listProjects`	GET	Get all active user projects, optionally filtered by folder or workspace.
Join`joinProject`	POST	Only used for workspaces
Search Projects`searchProjects`	GET	Search active user projects by name.
Unarchive Project`unarchiveProject`	POST	Marks a previously archived project as active again.
Update Project`updateProject`	POST	Updates a project and returns it.

Projects1

Permissionspermissions_api_v1_projects_permissions_get GET Returns a list of all the available roles and the associated actions they can perform in a project.

Reminder5

Create Reminder`createReminder`	POST	Create a new reminder for a task.
Delete Reminder`deleteReminder`	DELETE	Delete a reminder by ID.
Get Reminder`getReminder`	GET	Return a single reminder by ID.
Get Reminders`listReminders`	GET	Get all active reminders.
Update Reminder`updateReminder`	POST	Update an existing reminder.

Section8

Archive Section`archiveSection`	POST	Marks a section as archived.
Create Section`createSection`	POST	Create a new section
Delete Section`deleteSection`	DELETE	Delete the section and all of its tasks
Get Section`getSection`	GET	Return the section for the given section ID
Get Sections`listSections`	GET	Get all active sections for the user, optionally filtered by project.
Search Sections`searchSections`	GET	Search active sections by name, optionally filtered by project.
Unarchive Section`unarchiveSection`	POST	Marks a section as active again.
Update Section`updateSection`	POST	Update a section.

Sync1

Sync resources and commandssync POST Read incrementally and/or execute a heterogeneous batch of Todoist Sync commands in one form-encoded request.

Task12

Close Task`closeTask`	POST	Closes a task.
Create Task`createTask`	POST	Create a new task.
Delete Task`deleteTask`	DELETE	Delete a task and all of its subtasks.
Get Task`getTask`	GET	Returns a single active (non-completed) task by ID
Get Tasks`listTasks`	GET	Get all active tasks for the user.
Get Tasks By Filter`tasksByFilter`	GET	Get all tasks matching the filter.
Move Task`moveTask`	POST	Moves task to another project, section or parent.
Quick Add`quickAddTask`	POST	Add a new task using Quick Add with natural language processing.
Reopen Task`reopenTask`	POST	Reopens a task.
Tasks Completed By Completion Date`completedTasksByCompletionDate`	GET	Retrieves a list of completed tasks strictly limited by the specified completion date range (up to 3 months).
Tasks Completed By Due Date`completedTasksByDueDate`	GET	Retrieves a list of completed items strictly limited by the specified due date range (up to 6 weeks).
Update Task`updateTask`	POST	Updates an existing task.

Templates5

Create Project From File`create_project_from_file_api_v1_templates_create_project_from_file_post`	POST	A template can be imported in an existing project, or in a newly created one.
Export As File`export_as_file_api_v1_templates_file_get`	GET	Get a template for a project as a CSV file
Export As Url`export_as_url_api_v1_templates_url_get`	GET	Get a template for a project as a shareable URL.
Import Into Project From File`import_into_project_from_file_api_v1_templates_import_into_project_from_file_post`	POST	A template can be imported in an existing project, or in a newly created one.
Import Into Project From Template Id`import_into_project_from_template_id_api_v1_templates_import_into_project_from_template_id_post`	POST	Import a saved template into an existing project.

Uploads3

Delete Upload`delete_upload_api_v1_uploads_delete`	DELETE	Delete an uploaded file.
Upload File`upload_file_api_v1_uploads_post`	POST	Upload a file to Todoist.
Upload File`upload_file_api_v1_uploads_post_raw`	POST	Upload a file to Todoist.

User3

Get Productivity Stats`get_productivity_stats_api_v1_tasks_completed_stats_get`	GET	Get comprehensive productivity statistics for the authenticated user.
Update Notification Setting`update_notification_setting_api_v1_notification_setting_put`	PUT	Update a notification delivery preference.
User Info`user_info_api_v1_user_get`	GET	Get information about the currently authenticated user.

Workspace19

Accept Invitation`accept_invitation_api_v1_workspaces_invitations__invite_code__accept_put`	PUT	Accept a workspace invitation.
Active Projects`active_projects_api_v1_workspaces__workspace_id__projects_active_get`	GET	Returns all active workspace projects, including those visible but not joined by the user.
All Invitations`all_invitations_api_v1_workspaces_invitations_all_get`	GET	Return a list containing details of all pending invitation to a workspace.
Archived Projects`archived_projects_api_v1_workspaces__workspace_id__projects_archived_get`	GET	Return archived projects in a workspace.
Create Workspace`create_workspace_api_v1_workspaces_post`	POST	Creates a new workspace and returns it.
Delete Invitation`delete_invitation_api_v1_workspaces_invitations_delete_post`	POST	Deletes a workspace invitation.
Delete Workspace`delete_workspace_api_v1_workspaces__workspace_id__delete`	DELETE	Deletes a workspace.
Get Workspace`get_workspace_api_v1_workspaces__workspace_id__get`	GET	Returns a workspace by ID.
Get Workspaces`get_workspaces_api_v1_workspaces_get`	GET	Returns all workspaces where the user is a member.
Get Workspaces Users`get_workspaces_users_api_v1_workspaces_users_get`	GET	Returns all workspace users for a given workspace if workspace id is provided.
Invitations`invitations_api_v1_workspaces_invitations_get`	GET	Return a list of user emails who have a pending invitation to a workspace.
Invite Workspace Users`invite_workspace_users_api_v1_workspaces__workspace_id__users_invite_post`	POST	Invites users to a workspace by email.
Join`join_api_v1_workspaces_join_post`	POST	Join a workspace via link or via workspace ID, if the user can auto-join the workspace by domain.
Plan Details`plan_details_api_v1_workspaces_plan_details_get`	GET	Lists details of the workspace's current plan and usage
Reject Invitation`reject_invitation_api_v1_workspaces_invitations__invite_code__reject_put`	PUT	Reject a workspace invitation.
Remove Workspace User`remove_workspace_user_api_v1_workspaces__workspace_id__users__user_id__delete`	DELETE	Removes a user from a workspace.
Update Logo`update_logo_api_v1_workspaces_logo_post`	POST	Upload an image to be used as the workspace logo.
Update Workspace`update_workspace_api_v1_workspaces__workspace_id__post`	POST	Updates an existing workspace and returns it.
Update Workspace User`update_workspace_user_api_v1_workspaces__workspace_id__users__user_id__post`	POST	Updates a workspace user's role.