clickup_create_webhook
Register a webhook to push ClickUp events to your HTTPS endpoint, with optional filters for specific Spaces, Folders, Lists, or Tasks.
Instructions
Register a webhook that pushes ClickUp events to your endpoint.
Subscribes an HTTPS endpoint to one or more event types across a Workspace,
optionally narrowed to a single Space, Folder, List, or Task. Pass
events=['*'] to receive every event. ClickUp responds with the new webhook
id and a health object (status/fail_count) reflecting delivery health.
When to Use:
To wire ClickUp into an external system (CI, chatops, sync jobs) on task or hierarchy changes.
To watch a single List/Task by setting the matching location filter.
When NOT to Use:
To inspect or repair existing webhooks — use
clickup_get_webhooksthenclickup_update_webhook.For one-off reads of data — call the relevant read tool directly.
Returns: A confirmation with the new webhook id, its health status, and the subscribed events.
Examples:
params = {"endpoint": "https://x.io/hook", "events": ["taskCreated", "taskUpdated"]}
params = {"endpoint": "https://x.io/hook", "events": ["*"], "list_id": "901300"}
Error Handling:
400 → invalid/unreachable endpoint or unknown event name; 404 → unknown
team/location id. Errors return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |