> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Todoist

> How to set up the Todoist connector, plus the actions and events that are available.

![Todoist](https://stackone-logos.com/api/todoist/filled/svg)

v2.0.1[See changelog](https://docs.stackone.com/connectors/todoist/changelog.md)

[62 actions](#actions) · [25 events](#events) · 2 auth methods

Project Management
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/todoist/guides/connector-profile/oauth-2-0.md)
>
> Requires creating an app in the Todoist App Management Console.

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/todoist/guides/connector-profile/api-key.md)
>
> No app registration required. Uses the personal API token of a single Todoist user, which has full access to that user's...

Optionally, configure receiving Events for Todoist into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/todoist/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/todoist/guides/link-account/oauth-2-0.md)

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/todoist/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Key

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

data:delete

data:read

data:read\_write

project:delete

task:add

No scopes found

62 actions

ActionDescriptionRequired scopes

Get Activity Logs`todoist_get_activity_logs`

Get paginated activity logs for the user

`data:read`

List Comments`todoist_list_comments`

Retrieve all comments for a task or project

`data:read`

Create Comment`todoist_create_comment`

Create a new comment on a task or project

`data:read_write`

Get Comment`todoist_get_comment`

Retrieve a specific comment by ID

`data:read`

Update Comment`todoist_update_comment`

Update an existing comment

`data:read_write`

Delete Comment`todoist_delete_comment`

Delete a comment

`data:delete`

Get Unified Credentials`todoist_unified_get_me`

Get the current Todoist connection's unified credentials and identity.

`data:read`

IAM Auth Test`todoist_auth_test`

Validate the current token and return the raw, unmapped Todoist /user response. Bypasses the unified IAM credentials sch...

`data:read`

List Unified Organizations`todoist_unified_list_organizations`

List unified organizations in Todoist.

`data:read`

Get Unified Organization`todoist_unified_get_organization`

Get a unified Todoist organization by ID.

`data:read`

List Unified Resource Users`todoist_unified_list_resource_users`

List unified resource users in Todoist.

`data:read`

List Unified Resource Types`todoist_unified_list_resource_types`

List unified resource types in Todoist.

`data:read`

List Unified Roles`todoist_unified_list_roles`

List unified roles in Todoist.

`data:read`

Get Unified Role`todoist_unified_get_role`

Get a unified Todoist role by ID.

`data:read`

List Unified Users`todoist_unified_list_users`

List unified users in Todoist.

`data:read`

Get Unified User`todoist_unified_get_user`

Get a unified Todoist user by ID.

`data:read`

List Labels`todoist_list_labels`

Get all user labels

`data:read`

Get Label`todoist_get_label`

Get a label by ID

`data:read`

Create Label`todoist_create_label`

Create a new label

`data:read_write`

Update Label`todoist_update_label`

Update an existing label

`data:read_write`

Delete Label`todoist_delete_label`

Delete a label

`data:delete`

Search Labels`todoist_search_labels`

Search user labels by name

`data:read`

List Shared Labels`todoist_list_shared_labels`

Get shared labels from active tasks

`data:read`

Rename Shared Label`todoist_rename_shared_label`

Rename a shared label across all tasks

`data:read_write`

Remove Shared Label`todoist_remove_shared_label`

Remove a shared label from all tasks

`data:delete`

List Projects`todoist_list_projects`

Get all active user projects

`data:read`

Get Project`todoist_get_project`

Get a project by ID

`data:read`

Create Project`todoist_create_project`

Create a new project

`data:read_write`

Update Project`todoist_update_project`

Update an existing project

`data:read_write`

Delete Project`todoist_delete_project`

Delete a project

`project:delete`

Search Projects`todoist_search_projects`

Search active projects by name

`data:read`

List Archived Projects`todoist_list_archived_projects`

Get all archived projects

`data:read`

Archive Project`todoist_archive_project`

Archive a project

`data:read_write`

Unarchive Project`todoist_unarchive_project`

Unarchive a project

`data:read_write`

Get Project Permissions`todoist_get_project_permissions`

Get available project roles and actions

`data:read`

List Project Collaborators`todoist_list_project_collaborators`

Get all collaborators for a project

`data:read`

Join Project`todoist_join_project`

Join a workspace project

`data:read_write`

List Sections`todoist_list_sections`

Get all active sections

`data:read`

Get Section`todoist_get_section`

Get a section by ID

`data:read`

Create Section`todoist_create_section`

Create a new section

`data:read_write`

Update Section`todoist_update_section`

Update an existing section

`data:read_write`

Delete Section`todoist_delete_section`

Delete a section

`data:delete`

Archive Section`todoist_archive_section`

Mark a section as archived

`data:read_write`

Unarchive Section`todoist_unarchive_section`

Mark a section as active again

`data:read_write`

Search Sections`todoist_search_sections`

Search active sections by name

`data:read`

List Tasks`todoist_list_tasks`

Get all active tasks for the user

`data:read`

Get Task`todoist_get_task`

Get a task by ID

`data:read`

Create Task`todoist_create_task`

Create a new task

`task:add`

Update Task`todoist_update_task`

Update an existing task

`data:read_write`

Delete Task`todoist_delete_task`

Delete a task

`data:delete`

Close Task`todoist_close_task`

Close a task

`data:read_write`

Reopen Task`todoist_reopen_task`

Reopen a task

`data:read_write`

Move Task`todoist_move_task`

Move task to another project, section or parent

`data:read_write`

Quick Add Task`todoist_quick_add_task`

Add a task using Quick Add

`task:add`

Get Tasks By Filter`todoist_get_tasks_by_filter`

Get all tasks matching a filter

`data:read`

Get Tasks Completed By Completion Date`todoist_get_tasks_completed_by_completion_date`

Get completed tasks by completion date range

`data:read`

Get Tasks Completed By Due Date`todoist_get_tasks_completed_by_due_date`

Get completed tasks by due date range

`data:read`

Upload File`todoist_upload_file`

Upload a file to Todoist

`data:read_write`

Delete Upload`todoist_delete_upload`

Delete an uploaded file

`data:delete`

Get User Info`todoist_get_user_info`

Get information about the current user

`data:read`

Get Productivity Stats`todoist_get_productivity_stats`

Get comprehensive productivity statistics

`data:read`

Update Notification Setting`todoist_update_notification_setting`

Update a notification setting

`data:read_write`

## Events

Tags

Select all
|
Clear

Comments

Filters

Labels

Projects

Reminders

Sections

Tasks

Webhooks

No tags found

25 events

EventDescriptionTags

Task Added Webhook`todoist_webhook_item_added`

Processes Todoist item:added events.

TasksWebhooks

Task Updated Webhook`todoist_webhook_item_updated`

Processes Todoist item:updated events.

TasksWebhooks

Task Deleted Webhook`todoist_webhook_item_deleted`

Processes Todoist item:deleted events.

TasksWebhooks

Task Completed Webhook`todoist_webhook_item_completed`

Processes Todoist item:completed events.

TasksWebhooks

Task Uncompleted Webhook`todoist_webhook_item_uncompleted`

Processes Todoist item:uncompleted events.

TasksWebhooks

Comment Added Webhook`todoist_webhook_note_added`

Processes Todoist note:added events.

CommentsWebhooks

Comment Updated Webhook`todoist_webhook_note_updated`

Processes Todoist note:updated events.

CommentsWebhooks

Comment Deleted Webhook`todoist_webhook_note_deleted`

Processes Todoist note:deleted events.

CommentsWebhooks

Project Added Webhook`todoist_webhook_project_added`

Processes Todoist project:added events.

ProjectsWebhooks

Project Updated Webhook`todoist_webhook_project_updated`

Processes Todoist project:updated events.

ProjectsWebhooks

Project Deleted Webhook`todoist_webhook_project_deleted`

Processes Todoist project:deleted events.

ProjectsWebhooks

Project Archived Webhook`todoist_webhook_project_archived`

Processes Todoist project:archived events.

ProjectsWebhooks

Project Unarchived Webhook`todoist_webhook_project_unarchived`

Processes Todoist project:unarchived events.

ProjectsWebhooks

Section Added Webhook`todoist_webhook_section_added`

Processes Todoist section:added events.

SectionsWebhooks

Section Updated Webhook`todoist_webhook_section_updated`

Processes Todoist section:updated events.

SectionsWebhooks

Section Deleted Webhook`todoist_webhook_section_deleted`

Processes Todoist section:deleted events.

SectionsWebhooks

Section Archived Webhook`todoist_webhook_section_archived`

Processes Todoist section:archived events.

SectionsWebhooks

Section Unarchived Webhook`todoist_webhook_section_unarchived`

Processes Todoist section:unarchived events.

SectionsWebhooks

Label Added Webhook`todoist_webhook_label_added`

Processes Todoist label:added events.

LabelsWebhooks

Label Updated Webhook`todoist_webhook_label_updated`

Processes Todoist label:updated events.

LabelsWebhooks

Label Deleted Webhook`todoist_webhook_label_deleted`

Processes Todoist label:deleted events.

LabelsWebhooks

Filter Added Webhook`todoist_webhook_filter_added`

Processes Todoist filter:added events.

FiltersWebhooks

Filter Updated Webhook`todoist_webhook_filter_updated`

Processes Todoist filter:updated events.

FiltersWebhooks

Filter Deleted Webhook`todoist_webhook_filter_deleted`

Processes Todoist filter:deleted events.

FiltersWebhooks

Reminder Fired Webhook`todoist_webhook_reminder_fired`

Processes Todoist reminder:fired events.

RemindersWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.