ClickUp Create Task

View as Markdown

GET
/workspaces
/:workspace
/projects
/:project_name
/pipelines
/:pipeline_id
/actions
/:action_id

Returns details of a single ClickUp Create Task action

Request

REQUIRED SCOPES

PIPELINE_READ

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

project_namerequiredstring

The human-readable ID of the project

Example: "my-project"

pipeline_idrequiredinteger

The ID of the pipeline

Example: 123

action_idrequiredinteger

The ID of the action

Example: 456

Response

RESPONSE BODY

typestring

The type of the action

Value: CLICKUP_CREATE_TASK

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

idinteger

The ID of the action

namestring

The name of the action

current_revisionstring

The git revision of the last successful run of the action

trigger_timestring enum

Specifies when the action should be executed

Allowed enum:

ON_EVERY_EXECUTION,

ON_FAILURE,

ON_BACK_TO_SUCCESS,

ON_WARNING,

ON_WAIT_FOR_APPROVE,

ON_TERMINATE

trigger_conditionsTriggerConditionView[]

The list of trigger conditions to meet so that the action can be triggered

run_nextstring enum

Defines whether the action should run in parallel with the next one

Allowed enum:

WAIT_ON_SUCCESS,

IN_SOFT_PARALLEL,

IN_HARD_PARALLEL

run_only_on_first_failureboolean

Defines whether the action should be executed on each failure. Restricted to and required if the trigger_time is ON_FAILURE

variablesEnvironmentVariableView[]

The list of variables you can use the action

disabledboolean

When set to true the action is disabled. By default it is set to false

timeoutinteger

The timeout in seconds

ignore_errorsboolean

If set to true the execution will proceed, mark action as a warning and jump to the next action. Doesn't apply to deployment actions

retry_countinteger

Number of retries if the action fails

retry_intervalinteger

Delay time between auto retries in seconds

last_execution_statusstring enum

The status of the last run of the action

Allowed enum:

INPROGRESS,

ENQUEUED,

TERMINATED,

SUCCESSFUL,

FAILED,

INITIAL,

NOT_EXECUTED,

SKIPPED,

TERMINATING,

WAITING_FOR_APPLY,

WAITING_FOR_VARIABLES,

WAITING_FOR_SETTABLE_VARIABLES,

WAITING_FOR_VT_SESSION

pipelineShortPipelineView

Short representation of a pipeline

permissionsPermissionsView

Access permissions configuration

loopstring[]

The list of commands that will be executed in a loop

integrationIntegrationIdentifierView

The integration used by the action

spacestring

The name of the ClickUp space the list belongs to. Optional, narrows the search when several lists share the same name

folderstring

The name of the ClickUp folder the list belongs to. Optional, narrows the search when several lists share the same name. Leave empty to match a list that is not in any folder

liststring

The name of the ClickUp list to create the task in

titlestring

The title of the task

descriptionstring

The description of the task. Markdown is supported

statusstring

The status of the task, as displayed in ClickUp

prioritystring

The priority of the task. One of urgent, high, normal, low

tagsstring[]

The names of the tags to set on the task. Every tag must already exist in the space of the list

assigneesstring[]

The email addresses of the people to assign the task to

due_datestring

The due date of the task. Epoch milliseconds, an ISO-8601 date time or yyyy-MM-dd

start_datestring

The start date of the task. Epoch milliseconds, an ISO-8601 date time or yyyy-MM-dd

time_estimateinteger

The time estimate of the task, in minutes

parentstring

The id of the parent task. When set, the task is created as its subtask

custom_fieldsClickUpCustomFieldValue[]

The custom fields to set on the task, by field name

attachmentsstring[]

The paths of the files to attach to the task, relative to the pipeline filesystem

commentstring

The comment to add to the task

comment_attachmentsstring[]

The paths of the files to link in the comment. ClickUp has no comment attachments - the files are uploaded as task attachments and their links are appended to the comment

notify_allboolean

Set to true to notify everyone assigned to the task

Last modified on Sep 28, 2026

Add action Edit action

Request example

CURL
curl -X GET "https://api.buddy.works/workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/actions/:action_id" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json"

STATUS
200 OK