Overview
This node integrates with TickTick, a task management application, to manage tasks and projects programmatically. Specifically, the Task Complete operation marks a specified task within a project as completed. This is useful in automation workflows where task status updates need to be synchronized or triggered based on external events, such as completing a task after a related process finishes.
Practical examples:
- Automatically mark a TickTick task as complete when a support ticket is resolved.
- Complete a task in TickTick once a document review workflow finishes.
- Sync task completion status from another system into TickTick via n8n.
Properties
| Name | Meaning |
|---|---|
| Project Name or ID | Select the project containing the task, either by choosing from a list of available projects or specifying the project ID using an expression. |
| Task Name or ID | Select the specific task to complete within the chosen project, either from a list filtered by the selected project or by specifying the task ID using an expression. |
Output
The node outputs a JSON array containing the response from the TickTick API after marking the task as complete. The structure typically includes details about the updated task, confirming its completion status. No binary data output is produced by this operation.
Example output snippet (simplified):
[
{
"id": "task-id",
"title": "Example Task",
"status": "completed",
"projectId": "project-id",
...
}
]
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication configured in n8n.
- The node depends on TickTick's REST API endpoints for projects and tasks.
- Proper permissions in TickTick are necessary to update task statuses.
Troubleshooting
Common issues:
- Providing invalid or missing project/task IDs will cause errors.
- Insufficient permissions or expired OAuth tokens can lead to authorization failures.
- Network connectivity problems may prevent API requests from succeeding.
Error messages and resolutions:
"The resource "task" is not known!"— Ensure the Resource parameter is set correctly."The operation "complete" is not known!"— Verify the Operation parameter is set to "Complete".- JSON parsing errors (not typical for this operation but possible if custom JSON input is used elsewhere) — Check that any JSON inputs are valid.
- Authorization errors — Re-authenticate the TickTick credentials in n8n.