TickTick

Create, list, and complete tasks in TickTick.

ProductivityAPI key8 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (8)
complete_task
create_task
custom_api_call
delete_task
find_task
get_project
get_task
update_task
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("ticktick", "complete_task", {
    "projectId": "<projectId>",
    "taskId": "<taskId>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("TickTick answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "ticktick-complete-task",
  name: "TickTick: Complete Task",
  description: "Calls TickTick when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("ticktick", {
      "action": "complete_task",
      "projectId": "<projectId>",
      "taskId": "<taskId>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/ticktick/complete_task" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"projectId":"<projectId>","taskId":"<taskId>"}}'

Actions

complete_taskin catalog

Complete Task. Marks an existing task as completed.

Input	Type	Description
`projectId`required	id (picked from your account)	List
`taskId`required	id (picked from your account)	The ID of the task to complete.

create_taskin catalog

Create Task. Creates a new in a specific list.

Input	Type	Description
`projectId`required	id (picked from your account)	The list to create the task in.
`title`required	text	Task Title
`content`optional	long text	Task Content
`desc`optional	long text	Description of the checklist, often used with subtasks (items).
`startDate`optional	date-time (ISO)	Start Date
`dueDate`optional	date-time (ISO)	Due Date
`priority`optional	one of "0" \| "1" \| "3" \| "5"	Priority

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

delete_task

Delete Task. Deletes an existing task.

Input	Type	Description
`projectId`required	id (picked from your account)	The list the task belongs to.
`taskId`required	id (picked from your account)	The ID of the task to delete.

find_task

Find Task. Finds tasks in a specific project by their title.

Input	Type	Description
`projectId`required	id (picked from your account)	The list to search within.
`title`required	text	Task Title
`matchType`required	one of "contains" \| "exact"	Select how the title should be matched.

get_project

Get Task List. Retrieves the details of a specific task list by ID.

Input	Type	Description
`projectId`required	text	Select the list to retrieve details for.

get_task

Get Task. Retrieves the details of a specific task.

Input	Type	Description
`projectId`required	id (picked from your account)	The list the task belongs to.
`taskId`required	id (picked from your account)	The ID of the task to retrieve.

update_task

Update Task. Update an existing task.

Input	Type	Description
`projectId`required	id (picked from your account)	The list to update the task in.
`taskId`required	id (picked from your account)	The ID of the task to update.
`title`optional	text	Title
`content`optional	long text	Content
`desc`optional	long text	New description of the checklist items. Replaces existing.
`startDate`optional	date-time (ISO)	Start Date
`dueDate`optional	date-time (ISO)	Due Date
`priority`optional	one of "0" \| "1" \| "3" \| "5"	Priority

Details

Id: ticktick
Category: Productivity
Tags: tasks, todo, habits, personal-productivity
Package: @activepieces/piece-ticktick@0.1.5
Tier: Community