Integration reference
ClickUp Trigger and Action reference
Create and update ClickUp tasks, post comments, set Custom Fields, and start Workflows from signed Workspace events.
Authentication
Connect your ClickUp account through OAuth and authorize the Workspaces FastHook may access. FastHook encrypts the access token.
- Trigger account type:
oauth2; reconnect byoauth. - Action connection type:
oauth2; available modes: Connected ClickUp account.
Create or reuse the account from a Trigger or Action dialog, or manage it under Settings → Connected accounts. See Authentication and permissions for scopes and access diagnostics, or Connected accounts for reuse, reconnect, revocation, and credential rotation.
Scopes and permissions
The Trigger manifest does not declare a fixed base OAuth scope list. Installation access, API credentials, or the selected event configuration can still control available resources.
Operation-specific requirements appear in the tables below. Custom event selections can add scopes dynamically, so the current Trigger or Action dialog remains authoritative for the exact consent request.
Use ClickUp as a Trigger
The current provider manifest contains 30 available Trigger definitions. Representative definitions include:
- Task Created
- Task Updated
- Task Status Updated
- Task Comment Posted
- List Created
- Goal Updated
View all 30 available Trigger definitions
| Trigger | Manifest key | Delivery | Additional scopes |
|---|---|---|---|
| Any ClickUp Event | clickup.any_event.instant | instant | None declared |
| Custom ClickUp Events | clickup.custom_webhook_events.instant | instant | None declared |
| Task Created | clickup.task_created.instant | instant | None declared |
| Task Updated | clickup.task_updated.instant | instant | None declared |
| Task Deleted | clickup.task_deleted.instant | instant | None declared |
| Task Priority Updated | clickup.task_priority_updated.instant | instant | None declared |
| Task Status Updated | clickup.task_status_updated.instant | instant | None declared |
| Task Assignee Updated | clickup.task_assignee_updated.instant | instant | None declared |
| Task Due Date Updated | clickup.task_due_date_updated.instant | instant | None declared |
| Task Tag Updated | clickup.task_tag_updated.instant | instant | None declared |
| Task Moved | clickup.task_moved.instant | instant | None declared |
| Task Comment Posted | clickup.task_comment_posted.instant | instant | None declared |
| Task Comment Updated | clickup.task_comment_updated.instant | instant | None declared |
| Task Time Estimate Updated | clickup.task_time_estimate_updated.instant | instant | None declared |
| Task Time Tracked Updated | clickup.task_time_tracked_updated.instant | instant | None declared |
| List Created | clickup.list_created.instant | instant | None declared |
| List Updated | clickup.list_updated.instant | instant | None declared |
| List Deleted | clickup.list_deleted.instant | instant | None declared |
| Folder Created | clickup.folder_created.instant | instant | None declared |
| Folder Updated | clickup.folder_updated.instant | instant | None declared |
| Folder Deleted | clickup.folder_deleted.instant | instant | None declared |
| Space Created | clickup.space_created.instant | instant | None declared |
| Space Updated | clickup.space_updated.instant | instant | None declared |
| Space Deleted | clickup.space_deleted.instant | instant | None declared |
| Goal Created | clickup.goal_created.instant | instant | None declared |
| Goal Updated | clickup.goal_updated.instant | instant | None declared |
| Goal Deleted | clickup.goal_deleted.instant | instant | None declared |
| Key Result Created | clickup.key_result_created.instant | instant | None declared |
| Key Result Updated | clickup.key_result_updated.instant | instant | None declared |
| Key Result Deleted | clickup.key_result_deleted.instant | instant | None declared |
Choose the narrowest event definition that fits the Workflow. Configure provider-specific resource and event filters in the Source dialog before adding broader Workflow Filters.
Use ClickUp Actions
The current Action manifest contains 7 operations. Representative Actions include:
- Create Task
- Update Task
- Get Task
- Add Task Comment
- Set Custom Field
- Custom API Request
View all 7 available Action definitions
| Action | Manifest key | Access and auth | Manifest rate limit |
|---|---|---|---|
| Create Task | clickup.create_task | None declared FastHook-managed account | 1/second |
| Update Task | clickup.update_task | None declared FastHook-managed account | 1/second |
| Get Task | clickup.get_task | None declared FastHook-managed account | 1/second |
| Delete Task | clickup.delete_task | None declared FastHook-managed account | 1/second |
| Add Task Comment | clickup.add_comment | None declared FastHook-managed account | 1/second |
| Set Custom Field | clickup.set_custom_field | None declared FastHook-managed account | 1/second |
| Custom API Request | clickup.custom_api_request | None declared FastHook-managed account | 1/second |
The Action editor reads its required permissions, fields, remote resource pickers, output schema, and rate limit from the provider manifest. Available fields can change with the selected operation and authentication mode.
Build a Workflow
- Create a Source using a ClickUp Trigger definition.
- Create a Workflow with that Source as its Trigger.
- Add the required ClickUp Action and select the connected account.
- Map Trigger or earlier-Step data into the Action fields with the field picker.
- Add a Filter, Paths, Delay, or Transformation when the route needs it.
- Activate the Workflow, produce a controlled event, and verify the run in Audit and in ClickUp.
Troubleshooting ClickUp
- The account is missing or cannot be selected
- Confirm the active FastHook team, provider, account status, and authentication mode. A disabled or revoked account cannot execute an Action.
- A resource picker is empty
- Verify that the connected provider identity can access the resource itself. OAuth consent does not add workspace, repository, channel, drive, project, base, or record permissions.
- The editor asks for additional scopes
- Reconnect the same account from the affected Trigger or Action so FastHook can request its current manifest scopes. Then reopen the editor and select the resource again.
- An active Workflow returns 401, 403, or a permission error
- Compare the selected operation’s access requirements below with the account recorded in Audit. Check provider-side membership and object access before repeating the Action.
- The provider returns 429 or a temporary 5xx
- Inspect the Step attempt and retryability in Audit. FastHook can retry temporary failures, but provider quotas and idempotency rules still apply.
Provider-specific checks
- Select one or more authorized Workspaces. FastHook creates and maintains webhook subscriptions for the selected events, verifies X-Signature over the raw request body, and suppresses repeat deliveries.
- ClickUp webhook payloads often contain resource IDs and change history rather than a complete task. Add Get Task when a later step needs the current task name, description, or Custom Fields; deleted tasks cannot be fetched.
- For Create Task, choose a Workspace, Space, optional Folder, and List. Leave Folder empty for folderless Lists. Status names must match the destination List. Due dates use Unix milliseconds.
- Webhook schemas are derived from official examples. They describe known fields and are not a guarantee that every field appears in every delivery.
- Disconnecting removes FastHook-managed webhooks and disables the account locally. Revoke FastHook in ClickUp API settings to remove provider-side access. Webhooks belonging to disabled ClickUp users stop delivering events.