Todoist
Overview
Pre-built tooling
✅ Authorization
| Tools | Status |
|---|---|
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | ✅ |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Tenklo on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-end type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | 🚫 (time to contribute: <48h) |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Others
| Function name | Description | Type | Source code |
|---|---|---|---|
archive-project | Archive a project. | Action | 🔗 Github |
close-task | Mark a task complete (close it). | Action | 🔗 Github |
create-comment | Create a comment on a task or a project | Action | 🔗 Github |
create-label | Create a personal label. | Action | 🔗 Github |
create-project | Create a project. | Action | 🔗 Github |
create-section | Create a section. | Action | 🔗 Github |
create-task | Create a task | Action | 🔗 Github |
delete-comment | Delete a comment | Action | 🔗 Github |
delete-label | Delete a personal label. | Action | 🔗 Github |
delete-project | Delete a project. | Action | 🔗 Github |
delete-section | Delete a section. | Action | 🔗 Github |
delete-task | Delete a task. | Action | 🔗 Github |
filter-tasks | List tasks matching a Todoist filter query. | Action | 🔗 Github |
get-comment | Retrieve a single comment. | Action | 🔗 Github |
get-label | Retrieve a single personal label. | Action | 🔗 Github |
get-project | Retrieve a single project. | Action | 🔗 Github |
get-section | Retrieve a single section. | Action | 🔗 Github |
get-task | Retrieve a single task. | Action | 🔗 Github |
list-comments | List comments on a task or a project. | Action | 🔗 Github |
list-completed-tasks-by-completion-date | List tasks completed within a date range, filtered by when they were completed. | Action | 🔗 Github |
list-completed-tasks-by-due-date | List tasks completed within a date range, filtered by their original due date. | Action | 🔗 Github |
list-labels | List the current user's personal labels. | Action | 🔗 Github |
list-projects | List projects. | Action | 🔗 Github |
list-sections | List sections, optionally scoped to a project. | Action | 🔗 Github |
list-shared-labels | List label names currently used across the user's tasks (not necessarily backed by a personal Label object). | Action | 🔗 Github |
list-tasks | List active (non-completed) Todoist tasks. | Action | 🔗 Github |
move-task | Move a task to a different project, section, or parent task. | Action | 🔗 Github |
quick-add-task | Create a task from a single natural-language string (Todoist's quick-add parser: due dates, #project, @label, assignee, priority all parsed from text). | Action | 🔗 Github |
remove-shared-label | Remove a label string from every task that references it | Action | 🔗 Github |
rename-shared-label | Rename a label string across every task that references it. | Action | 🔗 Github |
reopen-task | Reopen (uncomplete) a task. | Action | 🔗 Github |
unarchive-project | Unarchive a project. | Action | 🔗 Github |
update-comment | Update a comment's content. | Action | 🔗 Github |
update-label | Update a personal label's name, color, order, or favorite flag. | Action | 🔗 Github |
update-project | Update a project's fields (name, color, favorite, view style, description). | Action | 🔗 Github |
update-section | Rename a section. | Action | 🔗 Github |
update-task | Update a task's fields (content, description, labels, due date, priority, deadline, duration). | Action | 🔗 Github |
comments | Sync comments across all known tasks and projects. | Sync | 🔗 Github |
labels | Sync personal labels. | Sync | 🔗 Github |
projects | Sync projects. | Sync | 🔗 Github |
sections | Sync sections. | Sync | 🔗 Github |
tasks | Sync active (non-completed) tasks. | Sync | 🔗 Github |
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ |
Setup guide
No setup guide yet.
Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Useful links
- REST API docs
- Sync API docs
- Authorization guide
- List of OAuth scopes
- Information on rate limits for the REST API
- Information on rate limits for the Sync API
- Web API docs (their REST API)
Contribute useful links by editing this page
API gotchas
Contribute API gotchas by editing this page