Skip to main content

ClickUp Ticket

Type ID: clickupTicket  ·  Kind: Action  ·  Ports: 1 in, 1 out

Create and update ClickUp tasks (tickets).

Credentials​

Connect a ClickUp credential via the integration picker.

{
"credentials": {
"name": "clickup",
"id": "<credential-id>"
}
}

Resources & operations​

  • Ticket (ticket)
    • Create (create) - Create a new task in a List
    • Update (update) - Update one or more fields on a task
    • Update Status (updateStatus) - Change a task's status
    • Update Description (updateDescription) - Replace a task's description

For agent integrations (name: 'clickupTicket' in permissions.integrations), grant '*', a resource key, or an operation key — see Tools and Permissions:

Resource key (<resource>)Operation keys (<resource>.<operation>)
ticketticket.create, ticket.update, ticket.updateStatus, ticket.updateDescription

Properties​

Common​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ResourceresourceoptionsYesticketTicket (ticket)-
OperationoperationoptionsYescreateCreate (create), Update (update), Update Status (updateStatus), Update Description (updateDescription)resource = ticket

Ticket → Create​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
List IDlistIdstringYes''ID of the ClickUp List to create the task inresource = ticket, operation = create
NamenamestringYes''Name (title) of the taskresource = ticket, operation = create
DescriptiondescriptionstringNo''Plain-text description for the taskresource = ticket, operation = create
StatusstatusstringNo''Initial status name (must match a status configured on the target List)resource = ticket, operation = create
Assignee IDsassigneesstringNo''Comma-separated ClickUp user IDs to assign to the taskresource = ticket, operation = create
PrioritypriorityoptionsNo''None (''), Urgent (1), High (2), Normal (3), Low (4)resource = ticket, operation = create

Ticket → Update​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Task IDtaskIdstringYes''ID of the ClickUp task to updateresource = ticket, operation = update
NamenamestringNo''New name (title) for the task. Leave blank to keep the current name.resource = ticket, operation = update
DescriptiondescriptionstringNo''New plain-text description for the task. Leave blank to keep the current description.resource = ticket, operation = update
StatusstatusstringNo''New status name (must match a status configured on the task's List). Leave blank to keep the current status.resource = ticket, operation = update
PrioritypriorityoptionsNo''No Change (''), Urgent (1), High (2), Normal (3), Low (4)resource = ticket, operation = update

Ticket → Update Status​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Task IDtaskIdstringYes''ID of the ClickUp task to updateresource = ticket, operation = updateStatus
StatusstatusstringYes''New status name. Must exactly match a status configured on the task's List (e.g. "in progress", "complete").resource = ticket, operation = updateStatus

Ticket → Update Description​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
Task IDtaskIdstringYes''ID of the ClickUp task to updateresource = ticket, operation = updateDescription
DescriptiondescriptionstringYes''New plain-text description for the taskresource = ticket, operation = updateDescription

Notes​

  • For update, at least one of Name, Description, Status, or Priority must be provided.
  • ClickUp's update-task endpoint treats an empty description as "no change"; a single space is ClickUp's own documented way to explicitly clear a description. The updateDescription operation handles this automatically.