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

# TickTick

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ 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 | ✅ |

> [accordion] ✅ 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 |
| - | - | - |
| `add-task-comment` | Add a comment to a task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `assign-task` | Assign a task to a member of its project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `batch-upsert-tasks` | Create and/or update multiple tasks in a single request (up to 50 each). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `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. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `complete-task` | Mark a single task as completed. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `complete-tasks-batch` | Complete up to 50 tasks in a single project in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-column` | Create a new column (section) on a project, for kanban-style organization. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-project-group` | Create a new project group (folder). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-project` | Create a new project (list). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-task` | Create a new task in a project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-project-group` | Delete a project group (folder). Does not delete the projects inside it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-project` | Permanently delete a project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-task-comment` | Delete a comment from a task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-task-verified` | Delete a task and confirm removal through the filter endpoint, which reflects deletions immediately (unlike the direct task GET). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-task` | Permanently delete a task from a project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `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. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `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. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-project-data` | Get a project bundled with its undone tasks and kanban columns. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-project-members` | List the members of a TickTick project, for use with assign-task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-project` | Retrieve a single project by its ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-task` | Retrieve a single task by its project ID and task ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-columns` | List the kanban/section columns defined on a project. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-completed-tasks` | List up to 200 tasks completed within a time range, optionally scoped to specific projects. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-project-groups` | List the user's project groups (folders that group multiple projects together). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-projects` | List all of the user's projects (lists). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-task-comments` | List all comments on a task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-undone-tasks` | List undone tasks whose startDate falls within a date range of up to 14 days. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `move-task` | Move one or more tasks from one project to another in a single call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-tasks` | Search tasks by keyword, with optional project/tag/status/due-date filters. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `unassign-task` | Remove the assignee from a task. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-column` | Rename a column. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-project-group` | Rename a project group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-project` | Update a project's fields. Only send the fields you want to change. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-task` | Update a task's fields, sending only the fields to change plus the required id and projectId. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `projects` | Sync all of the user's TickTick projects (lists), removing any project deleted since the previous run. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `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](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

> [!NOTE]
>
> Nango has a [Nango-managed OAuth app](https://nango.dev/docs/guides/auth/auth-guide.md#nango-managed-oauth-apps) you can use in development and production. Select it when you create the integration.

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/ticktick.mdx)

## Useful links

* [REST API docs](https://developer.ticktick.com/api#/openapi)
* [Authorization guide](https://developer.ticktick.com/api#/openapi)
* [List of OAuth scopes](https://developer.ticktick.com/api#/openapi?id=first-step)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/ticktick.mdx)

## API gotchas

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/ticktick.mdx)


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