WEBINARSandboxes for AI agents, Oct 7th.Sandboxes: give your AI agents a real machine. Live on October 7th.Register free
Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & TunnelsYAMLBuddy GitCLIAPIFAQ

ClickUp Create Task

View as Markdown
  • POST
  • /workspaces
  • /:workspace
  • /projects
  • /:project_name
  • /pipelines
  • /:pipeline_id
  • /actions

Creates a new ClickUp Create Task action in the pipeline

Request

REQUIRED SCOPES
PIPELINE_WRITE
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

BODY PARAMETERS
typerequiredstring
The type of the action

Value: CLICKUP_CREATE_TASK

after_action_idinteger
The numerical ID of the action, after which this action should be added
namerequiredstring
The name 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
loopstring[]
The list of commands that will be executed in a loop
current_revisionstring
The git revision of the last successful run of the action
integrationrequiredClickUpIntegrationRef
ClickUp integration (CLICKUP)
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

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

Previous pageEdit actionNext pageGet action

Request example

curl -X POST "https://api.buddy.works/workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/actions" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Report failure to ClickUp",
  "type": "CLICKUP_CREATE_TASK",
  "trigger_time": "ON_FAILURE",
  "space": "Development",
  "folder": "Sprints",
  "list": "Backlog",
  "title": "Pipeline failed: $BUDDY_PIPELINE_NAME #$BUDDY_RUN_ID",
  "description": "Opened by run **$BUDDY_RUN_ID**",
  "status": "Open",
  "priority": "high",
  "tags": [
    "ci-failure",
    "needs-triage"
  ],
  "assignees": [
    "developer@example.com"
  ],
  "due_date": "$BUDDY_RUN_START_DATE",
  "start_date": "2026-09-01",
  "time_estimate": 120,
  "parent": "86a1b2c3d",
  "custom_fields": [
    {
      "name": "Story Points",
      "value": "8"
    }
  ],
  "attachments": [
    "reports/test-results.xml"
  ],
  "comment": "Automatically opened by Buddy",
  "comment_attachments": [
    "reports/summary.md"
  ],
  "notify_all": true,
  "integration": {
    "identifier": "our-clickup-prod"
  }
}'
STATUS
200 OK