> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticktick

> Task management and to-do list app for organizing projects, tasks, comments, and tags via your connected account.

Use TickTick when you need to create, update, complete, or review tasks and projects in your workflows. It also helps when you need comments, tags, or project data for routing work.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Ticktick account to use for this step. |
| Action | Yes | The Ticktick action to perform (for example Get User Projects, Get Project By ID, Get Project With Data, Create Project). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Ticktick in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get User Projects** | Retrieve all projects accessible to the connected account. |
| **Get Project By ID** | Retrieve a single project by its ID. |
| **Get Project With Data** | Retrieve a project along with its tasks and columns. |
| **Create Project** | Create a new project. |
| **Update Project** | Update an existing project. |
| **List All Tasks** | List all open tasks across your projects. |
| **Filter Tasks** | Return tasks matching project, date, priority, tag, kind, or status filters. |
| **Get Task By Project And ID** | Retrieve a task from a project by its IDs. |
| **Create Task** | Create a new task. |
| **Update Task** | Update an existing task. |
| **Complete Task** | Mark a task as complete. |
| **Batch Create Or Update Tasks** | Create or update up to 50 tasks in one request. |
| **Add Task Comment** | Add a comment to a task. |
| **List Task Comments** | List comments attached to a task. |
| **List Tags** | List the tags available to your account. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Ticktick response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Ticktick if you have not already done that.
2. Add a **Ticktick** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get User Projects** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a task from a form reply

1. Create Task
2. Update Task
3. Get Task By Project And ID

### Close completed work

1. List All Tasks
2. Complete Task
3. Add Task Comment

### Review a project and its tasks

1. Get Project By ID
2. Get Project With Data
3. List Task Comments

## Notes

* This step depends on a connected Ticktick integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Ticktick tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Ticktick as an Agent Tool

You can also add Ticktick as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Ticktick**. In the tool settings panel, choose the connected account the agent should use. The agent calls Ticktick actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.