create_task
Create a new TickTick task with title, project, due date, priority, tags, checklist items, and reminders. For subtasks, use set_subtask_parent after creation.
Instructions
Create a new TickTick task.
[Category: Tasks — Write] [Auth: V1]
[Related: update_task, complete_task, set_subtask_parent, build_recurrence_rule]
[Workflow: For subtasks → create_task then set_subtask_parent]
⚠️ SUBTASK TRAP — parentId is SILENTLY IGNORED by the V1 creation endpoint.
Passing parentId in the payload creates a standalone task with no error or warning.
ALWAYS use set_subtask_parent AFTER creation to establish the relationship.
Correct sequence: create_task (parent) → create_task / batch_create_tasks (children) → set_subtask_parent × N
Args:
title: Task title (required).
project_id: Target project ID. Omit → Inbox.
content: Body / description (plain text or markdown).
desc: Alt description field (used by some TickTick views).
priority: 0=none, 1=low, 3=medium, 5=high (Eisenhower: 5=urgent+important).
due_date: ISO 8601, e.g. "2026-03-10T09:00:00+0000".
start_date: ISO 8601.
time_zone: IANA timezone, e.g. "Europe/Paris". Recommended with dates.
tags: Tag strings, e.g. ["work", "urgent"].
checklist_items: Strings → each becomes a checklist item. Auto-sets kind=CHECKLIST.
all_day: True for all-day (no specific time).
kind: "TEXT", "NOTE", or "CHECKLIST". Auto-set if checklist_items given.
reminder_minutes: Minutes before due to remind, e.g. [0, 30, 1440].
0=at time, 30=30min before, 1440=1 day before.
recurrence: RRULE string (use build_recurrence_rule to generate).
column_id: Kanban column ID (for kanban-view projects).
Returns the created task with its assigned id.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| project_id | No | ||
| content | No | ||
| desc | No | ||
| priority | No | ||
| due_date | No | ||
| start_date | No | ||
| time_zone | No | ||
| tags | No | ||
| checklist_items | No | ||
| all_day | No | ||
| kind | No | ||
| reminder_minutes | No | ||
| recurrence | No | ||
| column_id | No |