Overview
This node integrates with TickTick, a task and project management application. It allows users to perform various operations on TickTick projects and tasks directly within an n8n workflow.
For the Project - Get operation specifically, the node retrieves information about a specific project by its name or ID. Optionally, it can fetch detailed project data beyond basic metadata.
Common scenarios include:
- Fetching project details to use in subsequent workflow steps.
- Retrieving project data for reporting or synchronization with other tools.
- Automating project status checks or updates based on external triggers.
Example: You might use this node to get a project's details when a new email arrives, then create a task in that project based on the email content.
Properties
| Name | Meaning |
|---|---|
| Project Name or ID | Select a project from a dropdown list or specify its ID using an expression. Identifies which project to retrieve. |
| Get Project with Data | Boolean option to decide whether to fetch just the project metadata (false) or include detailed project data (true). |
Output
The node outputs a JSON object representing the requested project information.
- If "Get Project with Data" is
false, the output contains basic project details such as project ID, name, color, kind, and view mode. - If
true, the output includes additional nested data related to the project (e.g., tasks or other associated entities).
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication.
- The node depends on TickTick's REST API endpoints under
/open/v1/project. - Proper API credentials must be configured in n8n to authorize requests.
Troubleshooting
- Invalid Project ID or Name: If the specified project does not exist or the ID is incorrect, the API will likely return an error or empty response. Verify the project identifier.
- Authentication Errors: Ensure the OAuth2 credentials are valid and have not expired.
- Network Issues: Connectivity problems may cause request failures; check network access to TickTick's API.
- JSON Parsing Errors: Not applicable for this operation since no JSON input is required here.
- Unknown Operation or Resource: The node throws errors if unsupported operations or resources are selected.