TickTick icon

TickTick

Interact with TickTick tasks and projects

Habit → List

AI-generated

Overview

This node operation lists habits from the TickTick service. It is useful for users who want to retrieve and manage their habits programmatically, such as for tracking progress or integrating habit data into other workflows. For example, a user might list all their active habits to display them in a dashboard or to analyze habit completion trends.

Use Case Examples

  1. List all active habits to review current habit tracking status.
  2. Include archived habits in the list to analyze past habits and their history.

Properties

Name Meaning
Authentication Selects the authentication method to use for accessing the TickTick API. Options include Access Token (V1 API), Email/Password (V2 API), and OAuth2 (V1 API). This determines how the node authenticates requests.
Include Archived Boolean flag to specify whether archived habits should be included in the list output. Defaults to false, meaning only active habits are listed.

Output

JSON

  • id - Unique identifier of the habit.
  • name - Name of the habit.
  • status - Current status of the habit (e.g., active, archived).
  • createdTime - Timestamp when the habit was created.
  • updatedTime - Timestamp when the habit was last updated.
  • additionalProperties - Other habit-related properties returned by the TickTick API.

Dependencies

  • Requires TickTick API credentials depending on the selected authentication method: Access Token, Email/Password session, or OAuth2 token.

Troubleshooting

  • If the node throws an 'Unsupported operation' error, verify that the resource is set to 'Habit' and the operation to 'List'.
  • Authentication errors may occur if the wrong credential type is selected; habits require the TickTick Session API (V2) credential (Email/Password).
  • If no habits are returned, check the 'Include Archived' option to ensure archived habits are included if needed.

Discussion