Clickup

Learn how to use Clickup with Composio

Overview

SLUG

CLICKUP

Description

ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
bearer_token
string
generic_api_key
stringRequired

Tools

SLUG: CLICKUP_CREATE_FOLDER

Creates a new clickup folder within the specified space, which must exist and be accessible.

Action Parameters

name
stringRequired
space_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_CREATE_LIST

Creates a new list in clickup within a specified, existing folder.

Action Parameters

assignee
integer
content
string
due_date
integer
due_date_time
boolean
folder_id
integerRequired
name
stringRequired
priority
integer
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_CREATE_TASK

Creates a new clickup task in a specific list, optionally as a subtask if a `parent` task id (which cannot be a subtask itself and must be in the same list) is provided.

Action Parameters

assignees
array
check_required_custom_fields
boolean
custom_fields
array
custom_item_id
integer
custom_task_ids
boolean
description
string
due_date
integer
due_date_time
boolean
links_to
string
list_id
integerRequired
name
stringRequired
notify_all
boolean
parent
string
priority
integer
start_date
integer
start_date_time
boolean
status
string
tags
array
team_id
integer
time_estimate
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_CREATE_TASK_COMMENT

Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.

Action Parameters

assignee
integerRequired
comment_text
stringRequired
custom_task_ids
boolean
notify_all
booleanRequired
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_DELETE_TASK

Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).

Action Parameters

custom_task_ids
boolean
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_GET_TASK

Retrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).

Action Parameters

custom_task_ids
boolean
include_markdown_description
boolean
include_subtasks
boolean
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_UPDATE_TASK

Updates attributes of an existing task; `team id` is required if `custom task ids` is true, use a single space (" ") for `description` to clear it, and provide at least one modifiable field.

Action Parameters

archived
boolean
assignees__add
array
assignees__rem
array
custom_item_id
integer
custom_task_ids
boolean
description
string
due_date
integer
due_date_time
boolean
name
string
parent
string
priority
integer
start_date
integer
start_date_time
boolean
status
string
task_id
stringRequired
team_id
integer
time_estimate
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_DEPENDENCY

Adds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends on` (task becomes waiting on) or `dependency of` (task becomes blocking), but not both; `team id` is required if `custom task ids` is true.

Action Parameters

custom_task_ids
boolean
depedency_of
string
depends_on
string
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_GUEST_TO_FOLDER

Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.

Action Parameters

folder_id
integerRequired
guest_id
integerRequired
include_shared
boolean
permission_level
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_GUEST_TO_LIST

Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.

Action Parameters

guest_id
integerRequired
include_shared
boolean
list_id
integerRequired
permission_level
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_GUEST_TO_TASK

Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.

Action Parameters

custom_task_ids
boolean
guest_id
integerRequired
include_shared
boolean
permission_level
stringRequired
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_TAGS_FROM_TIME_ENTRIES

Associates a list of specified tags with one or more time entries within a given team (workspace).

Action Parameters

tags
arrayRequired
team_id
integerRequired
time_entry_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_TAG_TO_TASK

Adds an existing tag to a specified task; team id is required if custom task ids is true.

Action Parameters

custom_task_ids
boolean
tag_name
stringRequired
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ADD_TASK_TO_LIST

Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.

Action Parameters

list_id
integerRequired
task_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_ATTACHMENTS_UPLOAD_FILE_TO_TASK_AS_ATTACHMENT

Deprecated: use `create task attachment` to upload a file to a task; requires `multipart/form-data`.

Action Parameters

attachment
array
custom_task_ids
boolean
task_id
stringRequired
team_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_AUTHORIZATION_GET_ACCESS_TOKEN

Deprecated: use `get access token` instead. exchanges a clickup oauth 2.0 authorization code for an access token.

Action Parameters

client_id
stringRequired
client_secret
stringRequired
code
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_AUTHORIZATION_GET_WORK_SPACE_LIST

Deprecated: use `get authorized teams workspaces` instead to retrieve workspaces (teams) accessible to the authenticated user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_AUTHORIZATION_VIEW_ACCOUNT_DETAILS

Deprecated: use `get authorized user` instead. retrieves details of the authenticated user's clickup account.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CLICKUP_CHANGE_TAG_NAMES_FROM_TIME_ENTRIES

Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.

Action Parameters

name
stringRequired
new_name
stringRequired
tag_bg
stringRequired
tag_fg
stringRequired
team_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired