create_project
Create a new project in TickTick with custom name, color, view mode (list, kanban, timeline), and optional folder assignment. Supports task and note types.
Instructions
Create a new TickTick project (list).
[Category: Projects] [Auth: V1 + V2 when group_id is provided]
[Related: list_projects, update_project, delete_project, list_project_folders]
[Workflow: Create project → manage_columns (for kanban) → create_task]
Args:
name: Project name (required).
color: Hex color, e.g. "#F18181".
kind: "TASK" (default) or "NOTE".
view_mode: "list", "kanban", or "timeline".
group_id: Folder ID to file project in (from list_project_folders).
⚠️ group_id ALWAYS requires a V2 follow-up — handled automatically here:
The V1 create endpoint silently ignores groupId in the payload (no error,
no warning — it just doesn't persist). This tool works around it by:
1. Creating the project via V1 to obtain the new project ID.
2. Immediately calling V2 POST /batch/project to assign the groupId.
The returned dict reflects groupId correctly. Verify with full_sync()
if needed — V1 list_projects always shows groupId=null regardless.
⚠️ Never try to assign group_id via a raw V1 update — it silently fails.
Always go through update_project(group_id=...) which also uses V2.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| color | No | ||
| kind | No | TASK | |
| view_mode | No | ||
| group_id | No |