ticktick_create_task
Create a new task in TickTick with title, due date, priority, and reminders. Supports markdown content, subtasks, and recurrence rules.
Instructions
Create a new task.
Args:
title (str): Task title. Required.
project_id (str, optional): Project ID. Defaults to inbox.
content (str, optional): Long-form content (markdown supported).
desc (str, optional): Short description / checklist subtitle.
all_day (bool, optional): True for all-day tasks.
start_date (str, optional): ISO 8601 start datetime, e.g.
"2026-04-13T09:00:00+01:00".
due_date (str, optional): ISO 8601 due datetime.
expected_day_of_week (str, optional): English weekday name. Required
when due_date is set; mismatch returns an error.
time_zone (str, optional): IANA timezone. Defaults to the system
timezone for date conversion.
reminders (list[str], optional): TickTick trigger strings, e.g.
["TRIGGER:-PT30M"].
repeat (str, optional): Recurrence rule (RFC 5545 RRULE).
priority (int, optional): 0=None, 1=Low, 3=Medium, 5=High.
sort_order (int, optional): Position within project.
items (list[dict], optional): Subtask items.
Returns:
JSON object containing the created task. If verification flags
an issue, _verification_warnings is attached. Without
due_date a warning is added because TickTick will not trigger
a reminder.
On failure: {"error": "...", "status": "error"}.
Limitations:
- builder() in ticktick-py sometimes omits dates,
reminders, priority and timezone; we re-populate them after
the call.
Agent Usage Guide:
- Always pair due_date with expected_day_of_week.
- Look up a project ID with ticktick_get_all(search="projects").
Example: ticktick_create_task( title="Replace kitchen tap washer", project_id="", due_date="2026-06-01T20:45:00+01:00", expected_day_of_week="Monday", time_zone="Europe/London", priority=3, )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| project_id | No | ||
| content | No | ||
| desc | No | ||
| all_day | No | ||
| start_date | No | ||
| due_date | No | ||
| expected_day_of_week | No | ||
| time_zone | No | ||
| reminders | No | ||
| repeat | No | ||
| priority | No | ||
| sort_order | No | ||
| items | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |