Overview
This node integrates with TickTick, a task management application, to create new tasks within specified projects. It allows users to add tasks by specifying essential details such as the project, title, and optional additional fields like description, due dates, priority, and more. This node is beneficial for automating task creation workflows, syncing tasks from other systems, or programmatically managing task lists in TickTick.
Practical examples:
- Automatically creating a task in TickTick when a new support ticket is received.
- Adding reminders or follow-up tasks based on calendar events.
- Syncing tasks from other project management tools into TickTick.
Properties
| Name | Meaning |
|---|---|
| JSON Parameters | Boolean flag to choose between entering additional task fields as raw JSON or through a structured form. |
| Project Name or ID | Select the target project by name or ID where the task will be created. Can be chosen from a dropdown list or specified dynamically using an expression. |
| Task Title | The title of the task to be created. This is a required field. |
| Additional Fields (JSON) | When JSON Parameters is true, this is a JSON object containing any extra task properties to set, following TickTick's API specification. |
| Additional Fields | When JSON Parameters is false, a collection of optional fields to specify additional task details: |
| - Task Content | Text content or notes related to the task. |
| - Description of Checklist | A description for any checklist associated with the task. |
| - All Day | Boolean indicating if the task lasts all day. |
| - Start Date | The start date and time of the task. |
| - Due Date | The due date and time for the task completion. |
| - Time Zone | Time zone for the start and due dates. Options include common zones like UTC, Europe/London, Asia/Tokyo, America/New_York, etc., or can be set via expression. |
| - Priority | Task priority level. Options are High (5), Medium (3), Low (1), or None (0). |
Output
The node outputs a JSON array containing the response from the TickTick API after creating the task. This typically includes the full details of the newly created task such as its unique ID, title, project association, timestamps, status, and any other fields supported by TickTick.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication.
- The node depends on TickTick's REST API endpoints for task creation.
- Proper configuration of the OAuth2 credentials in n8n is necessary to authorize API requests.
Troubleshooting
- Invalid JSON input: If using JSON parameters, malformed JSON will cause an error. Ensure the JSON is valid and correctly formatted.
- Missing required fields: The task title and project ID must be provided; otherwise, the API request will fail.
- API authentication errors: Ensure that the OAuth2 credentials are correctly configured and have not expired.
- Unknown resource or operation errors: These occur if unsupported resource or operation names are used; verify that "task" and "create" are selected.
- Empty JSON input error: When JSON parameters are enabled but no JSON is provided, the node throws an error indicating empty input.