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
- Create (
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>) |
|---|---|
ticket | ticket.create, ticket.update, ticket.updateStatus, ticket.updateDescription |
Properties
Common
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Resource | resource | options | Yes | ticket | Ticket (ticket) | - |
| Operation | operation | options | Yes | create | Create (create), Update (update), Update Status (updateStatus), Update Description (updateDescription) | resource = ticket |
Ticket → Create
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| List ID | listId | string | Yes | '' | ID of the ClickUp List to create the task in | resource = ticket, operation = create |
| Name | name | string | Yes | '' | Name (title) of the task | resource = ticket, operation = create |
| Description | description | string | No | '' | Plain-text description for the task | resource = ticket, operation = create |
| Status | status | string | No | '' | Initial status name (must match a status configured on the target List) | resource = ticket, operation = create |
| Assignee IDs | assignees | string | No | '' | Comma-separated ClickUp user IDs to assign to the task | resource = ticket, operation = create |
| Priority | priority | options | No | '' | None (''), Urgent (1), High (2), Normal (3), Low (4) | resource = ticket, operation = create |
Ticket → Update
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Task ID | taskId | string | Yes | '' | ID of the ClickUp task to update | resource = ticket, operation = update |
| Name | name | string | No | '' | New name (title) for the task. Leave blank to keep the current name. | resource = ticket, operation = update |
| Description | description | string | No | '' | New plain-text description for the task. Leave blank to keep the current description. | resource = ticket, operation = update |
| Status | status | string | No | '' | New status name (must match a status configured on the task's List). Leave blank to keep the current status. | resource = ticket, operation = update |
| Priority | priority | options | No | '' | No Change (''), Urgent (1), High (2), Normal (3), Low (4) | resource = ticket, operation = update |
Ticket → Update Status
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Task ID | taskId | string | Yes | '' | ID of the ClickUp task to update | resource = ticket, operation = updateStatus |
| Status | status | string | Yes | '' | 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
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Task ID | taskId | string | Yes | '' | ID of the ClickUp task to update | resource = ticket, operation = updateDescription |
| Description | description | string | Yes | '' | New plain-text description for the task | resource = 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
updateDescriptionoperation handles this automatically.