TickTick
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 |
|---|---|---|---|
add-task-comment | Add a comment to a task. | Action | 🔗 Github |
assign-task | Assign a task to a member of its project. | Action | 🔗 Github |
batch-upsert-tasks | Create and/or update multiple tasks in a single request (up to 50 each). | Action | 🔗 Github |
complete-task-and-verify | COMPOSITE: mark a task as completed and return its confirmed final state in one call, instead of trusting the complete endpoint's empty 200 response. | Action | 🔗 Github |
complete-task | Mark a single task as completed. | Action | 🔗 Github |
complete-tasks-batch | Complete up to 50 tasks in a single project in one call. | Action | 🔗 Github |
create-column | Create a new column (section) on a project, for kanban-style organization. | Action | 🔗 Github |
create-project-group | Create a new project group (folder). | Action | 🔗 Github |
create-project | Create a new project (list). | Action | 🔗 Github |
create-task | Create a new task in a project. | Action | 🔗 Github |
delete-project-group | Delete a project group (folder). Does not delete the projects inside it. | Action | 🔗 Github |
delete-project | Permanently delete a project. | Action | 🔗 Github |
delete-task-comment | Delete a comment from a task. | Action | 🔗 Github |
delete-task-verified | Delete a task and confirm removal through the filter endpoint, which reflects deletions immediately (unlike the direct task GET). | Action | 🔗 Github |
delete-task | Permanently delete a task from a project. | Action | 🔗 Github |
filter-tasks | Retrieve up to 200 tasks matching project, date, priority, tag, kind, and/or status filters - works across ALL projects when projectIds is omitted. | Action | 🔗 Github |
find-or-create-task-in-project | COMPOSITE: create a task inside a project identified by NAME, creating that project first if no project with that name exists yet. | Action | 🔗 Github |
get-project-data | Get a project bundled with its undone tasks and kanban columns. | Action | 🔗 Github |
get-project-members | List the members of a TickTick project, for use with assign-task. | Action | 🔗 Github |
get-project | Retrieve a single project by its ID. | Action | 🔗 Github |
get-task | Retrieve a single task by its project ID and task ID. | Action | 🔗 Github |
list-columns | List the kanban/section columns defined on a project. | Action | 🔗 Github |
list-completed-tasks | List up to 200 tasks completed within a time range, optionally scoped to specific projects. | Action | 🔗 Github |
list-project-groups | List the user's project groups (folders that group multiple projects together). | Action | 🔗 Github |
list-projects | List all of the user's projects (lists). | Action | 🔗 Github |
list-task-comments | List all comments on a task. | Action | 🔗 Github |
list-undone-tasks | List undone tasks whose startDate falls within a date range of up to 14 days. | Action | 🔗 Github |
move-task | Move one or more tasks from one project to another in a single call. | Action | 🔗 Github |
search-tasks | Search tasks by keyword, with optional project/tag/status/due-date filters. | Action | 🔗 Github |
unassign-task | Remove the assignee from a task. | Action | 🔗 Github |
update-column | Rename a column. | Action | 🔗 Github |
update-project-group | Rename a project group. | Action | 🔗 Github |
update-project | Update a project's fields. Only send the fields you want to change. | Action | 🔗 Github |
update-task | Update a task's fields, sending only the fields to change plus the required id and projectId. | Action | 🔗 Github |
projects | Sync all of the user's TickTick projects (lists), removing any project deleted since the previous run. | Sync | 🔗 Github |
tasks | Sync open, completed and abandoned tasks across all projects and the inbox, with a per-project fallback when the account-wide listing hits its 200-task cap. | 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
Contribute useful links by editing this page
API gotchas
Contribute API gotchas by editing this page