ClickUp logo

ClickUp

Project ManagementAPI tokenLive

Askel connects to your customer's ClickUp workspace, letting your product create tasks, move them through statuses, read time tracking data, and react to task events in the hierarchical workspace structure ClickUp teams use.

What you can do

Create tasks in any list

Use the ClickUp tasks endpoint to insert tasks with a name, description, due date, priority, assignees, and custom field values into any list in the workspace.

Update task status and fields

Update a task's status to move it through the customer's custom status flow, and update any custom fields including dropdowns, dates, and numbers.

Read time tracking entries

Fetch time tracking records attached to tasks using the time entries endpoint, useful for pulling billable hours into your product for invoicing or reporting.

Navigate workspace hierarchy

List spaces, folders, and lists in the workspace to build a mapping UI, so your team and the customer can agree on which list is the correct target.

Attach files to tasks

Upload files as task attachments using the attachments endpoint, useful for linking reports, exports, or signed documents to the relevant ClickUp task.

Receive webhook events

Subscribe to ClickUp webhooks for task creation, status change, and time-entry events. Askel routes incoming events to trigger steps in your workflow.

Sample use case

Creating ClickUp tasks for each deliverable when an onboarding project starts

You sell an agency project management tool. Clearwater Digital uses ClickUp to track all client work. When your product spins up a new client onboarding project, it should create a set of standard deliverable tasks in ClickUp, assigned to the right team members, with due dates based on the project timeline.

  1. 1

    Generate an API token

    Clearwater's ClickUp admin opens Profile Settings, navigates to Apps, and copies their Personal API Token. They paste it into your product's integration settings.

  2. 2

    Discover the workspace hierarchy

    Askel fetches Clearwater's spaces, folders, and lists. Your onboarding team picks the Client Onboarding list in the Projects space as the default target.

  3. 3

    Map statuses and custom fields

    Clearwater's list has statuses Open, In Progress, Review, and Done, plus a custom Client field. Your team maps your product's task states to the matching ClickUp statuses.

  4. 4

    Create the task set

    When your product creates a new onboarding project, Askel creates one task per deliverable template, each with the calculated due date, assignee email, and initial status Open.

  5. 5

    Track completions

    Askel receives a webhook event when a task moves to Done. Your product marks the corresponding deliverable as complete and updates the overall project progress.

Authentication

API token

The customer's ClickUp user opens Profile Settings, then Apps, and copies their Personal API Token. Askel stores the token and uses it for all API calls within that user's workspace. Personal API tokens give access to all workspaces the user belongs to, so customers should use a dedicated service user token if they want to limit the access scope.

Data flow

How Askel sits between your product and the customer's system

Data flow between Customer's ClickUp workspace, Askel, and Your productCustomer's ClickUp workspaceAPI endpointAskelauth · mapping · driftYour productyour backend
TasksCustom statusesCustom fieldsTime entriesAssigneesWebhook events

FAQ for ClickUp

Which ClickUp plans include API access?+
The ClickUp API is available on all plans including Free. Some advanced features, such as goal tracking and higher webhook event limits, require Business or above.
How are custom statuses handled?+
ClickUp statuses are per-list and vary by customer. Askel reads the status options for the configured list at connect time and surfaces them in the mapping editor. If a status is later renamed or removed, Askel pauses the affected step and notifies your team.
Can we create tasks in multiple lists?+
Yes. ClickUp supports a single task appearing in multiple lists. Askel can call the add_task_to_list endpoint after creation to add the task to additional lists.
What happens if the customer reorganises their workspace hierarchy?+
Askel stores list IDs rather than path names, so renaming a list or moving it to a different folder does not break the integration. If the list is deleted, Askel catches the 404 and notifies your team.
Ready to ship integrations faster?customers faster?implementations faster?
Join onboarding teams delivering integrations without the engineering queue,
catching drift before it breaks, and hitting go-live dates.
Security & Compliance
ISO 27001 Certified
GDPR Compliant

© 2025 Askel.ai. All rights reserved.