Clickup

clickup Webhooks API

Operations for creating, retrieving, updating, and deleting webhook subscriptions.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/team/{team_id}/webhook List my webhooks in a Workspace (v2) · Get Webhooks #
Ask an LLM
“Which webhooks have I set up for my ClickUp Workspace?”
“Does the v2 webhook list include ones created by other users?”
Tell an agent
List the v2 webhooks I created in Workspace {team_id}.
Show my API webhooks for {team_id} using v2.
POST /v2/team/{team_id}/webhook Subscribe to Workspace events (v2) · Create Webhook #
Ask an LLM
“Can I get notified at my own URL when tasks change in one List?”
“Does the v2 webhook service send from a fixed IP address I can allowlist?”
Tell an agent
Using v2, create a webhook in Workspace {team_id} sending {events} to {endpoint}.
Watch List {list_id} in {team_id} for {events} and post them to {endpoint} via v2.
PUT /v2/webhook/{webhook_id} Change a webhook's events (v2) · Update Webhook #
Ask an LLM
“Can I change which events a webhook listens for in v2?”
“How do I reactivate a webhook that was suspended?”
Tell an agent
Using v2, point webhook {webhook_id} at {endpoint} for events {events} with status {status}.
Set v2 webhook {webhook_id} to {status}, keeping endpoint {endpoint} and events {events}.
DELETE /v2/webhook/{webhook_id} Delete a webhook (v2) · Delete Webhook #
Ask an LLM
“How do I stop a webhook from monitoring events via v2?”
“Is there a v2 call to remove a webhook I no longer need?”
Tell an agent destructive · confirm first
Delete v2 webhook {webhook_id}.
Stop monitoring with webhook {webhook_id} by removing it through v2.
GET /team/{team_id}/webhook List webhook subscriptions (legacy path) · Get webhooks #
Ask an LLM
“On the older unversioned path, can I see each webhook's health information?”
“Does the legacy endpoint return subscribed events and status for every webhook?”
Tell an agent
On the legacy path, fetch webhook subscriptions with health info for Workspace {team_id}.
Using the older endpoint, report the status of every event subscription in {team_id}.
POST /team/{team_id}/webhook Create a webhook subscription (legacy path) · Create a webhook #
Ask an LLM
“Does the older unversioned endpoint return a shared secret for signing webhook payloads?”
“On the legacy path, can a subscription be scoped to a single task?”
Tell an agent
On the legacy path, subscribe {endpoint} to {events} in Workspace {team_id}.
Using the older endpoint, notify {endpoint} of {events} on task {task_id} in {team_id}.
PUT /webhook/{webhook_id} Edit a webhook subscription (legacy path) · Update a webhook #
Ask an LLM
“Can the older unversioned endpoint change only a subscription's URL?”
“On the legacy path, are all webhook fields optional on edit?”
Tell an agent
On the legacy path, move subscription {webhook_id} to URL {endpoint}.
Using the older endpoint, swap subscription {webhook_id}'s events for {events}.
DELETE /webhook/{webhook_id} Delete a webhook subscription (legacy path) · Delete a webhook #
Ask an LLM
“Do events stop immediately when a subscription is erased on the older unversioned path?”
“Is removing a webhook through the legacy endpoint permanent?”
Tell an agent destructive · confirm first
Permanently erase subscription {webhook_id} on the legacy path.
Using the older endpoint, cut off event delivery for {webhook_id}.

Documentation

📖
Documentation
https://developer.clickup.com/docs/tasks
📖
Documentation
https://developer.clickup.com/reference/get-spaces
📖
Documentation
https://developer.clickup.com/reference/get-lists
📖
Documentation
https://developer.clickup.com/reference/get-folders
📖
Documentation
https://developer.clickup.com/reference/get-goals
📖
Documentation
https://developer.clickup.com/reference/get-task-comments
📖
Documentation
https://developer.clickup.com/reference/get-teams
📖
Documentation
https://developer.clickup.com/docs/webhooks
📖
Documentation
https://developer.clickup.com/reference/get-accessible-custom-fields
📖
Documentation
https://developer.clickup.com/reference/get-time-entries-within-a-date-range
📖
Documentation
https://developer.clickup.com/reference/get-views
📖
Documentation
https://developer.clickup.com/docs/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-webhooks-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/asyncapi/clickup-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clickup:clickup-webhooks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickup-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Webhooks API
  version: '2.0'
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-webhooks-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
tags:
- name: Webhooks
paths:
  /v2/team/{team_id}/webhook:
    parameters: []
    get:
      summary: Get Webhooks
      tags:
      - Webhooks
      description: View the webhooks created via the API for a Workspace. This endpoint returns webhooks created by the authenticated user.
      operationId: GetWebhooks
      parameters:
      - name: team_id
        in: path
        description: Workspace ID
        required: true
        style: simple
        schema:
          type: number
          contentEncoding: double
          examples:
          - 123
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: GetWebhooksresponse
                required:
                - webhooks
                type: object
                properties:
                  webhooks:
                    type: array
                    items:
                      $ref: '#/paths/~1v2~1webhook~1{webhook_id}/put/responses/200/content/application~1json/schema/properties/webhook'
                    description: ''
                examples:
                - webhooks:
                  - id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                    userid: 183
                    team_id: 108
                    endpoint: https://yourdomain.com/webhook
                    client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                    events:
                    - taskCreated
                    - taskUpdated
                    - taskDeleted
                    - taskPriorityUpdated
                    - taskStatusUpdated
                    - taskAssigneeUpdated
                    - taskDueDateUpdated
                    - taskTagUpdated
                    - taskMoved
                    - taskCommentPosted
                    - taskCommentUpdated
                    - taskTimeEstimateUpdated
                    - taskTimeTrackedUpdated
                    - listCreated
                    - listUpdated
                    - listDeleted
                    - folderCreated
                    - folderUpdated
                    - folderDeleted
                    - spaceCreated
                    - spaceUpdated
                    - spaceDeleted
                    - goalCreated
                    - goalUpdated
                    - goalDeleted
                    - keyResultCreated
                    - keyResultUpdated
                    - keyResultDeleted
                    task_id: null
                    list_id: null
                    folder_id: null
                    space_id: null
                    health:
                      status: failing
                      fail_count: 5
                    secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
              example:
                webhooks:
                - id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                  userid: 183
                  team_id: 108
                  endpoint: https://yourdomain.com/webhook
                  client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                  events:
                  - taskCreated
                  - taskUpdated
                  - taskDeleted
                  - taskPriorityUpdated
                  - taskStatusUpdated
                  - taskAssigneeUpdated
                  - taskDueDateUpdated
                  - taskTagUpdated
                  - taskMoved
                  - taskCommentPosted
                  - taskCommentUpdated
                  - taskTimeEstimateUpdated
                  - taskTimeTrackedUpdated
                  - listCreated
                  - listUpdated
                  - listDeleted
                  - folderCreated
                  - folderUpdated
                  - folderDeleted
                  - spaceCreated
                  - spaceUpdated
                  - spaceDeleted
                  - goalCreated
                  - goalUpdated
                  - goalDeleted
                  - keyResultCreated
                  - keyResultUpdated
                  - keyResultDeleted
                  task_id: null
                  list_id: null
                  folder_id: null
                  space_id: null
                  health:
                    status: failing
                    fail_count: 5
                  secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
      deprecated: false
      security:
      - Authorization_Token: []
    post:
      summary: Create Webhook
      tags:
      - Webhooks
      description: 'Set up a webhook to monitor for events.

        We do not have a dedicated IP address for webhooks. We use our domain name and dynamic addressing.'
      operationId: CreateWebhook
      parameters:
      - name: team_id
        in: path
        description: Workspace ID
        required: true
        style: simple
        schema:
          type: number
          contentEncoding: double
          examples:
          - 123
      requestBody:
        description: You can subscribe to specific events, and one specific location per webhook. [Learn more](doc:webhooks).
        content:
          application/json:
            schema:
              title: CreateWebhookrequest
              required:
              - endpoint
              - events
              type: object
              properties:
                endpoint:
                  type: string
                events:
                  type: array
                  description: See [documentation](doc:webhooks#task-webhooks) for available event options. Use `*` to subscribe to all events.
                  items:
                    type: string
                space_id:
                  type: integer
                folder_id:
                  type: integer
                list_id:
                  type: integer
                task_id:
                  type: string
              examples:
              - endpoint: https://yourdomain.com/webhook
                events:
                - taskCreated
                - taskUpdated
                - taskDeleted
                - taskPriorityUpdated
                - taskStatusUpdated
                - taskAssigneeUpdated
                - taskDueDateUpdated
                - taskTagUpdated
                - taskMoved
                - taskCommentPosted
                - taskCommentUpdated
                - taskTimeEstimateUpdated
                - taskTimeTrackedUpdated
                - listCreated
                - listUpdated
                - listDeleted
                - folderCreated
                - folderUpdated
                - folderDeleted
                - spaceCreated
                - spaceUpdated
                - spaceDeleted
                - goalCreated
                - goalUpdated
                - goalDeleted
                - keyResultCreated
                - keyResultUpdated
                - keyResultDeleted
                space_id: 1234
                folder_id: 5678
                list_id: 9876
                task_id: abc1234
            example:
              endpoint: https://yourdomain.com/webhook
              events:
              - taskCreated
              - taskUpdated
              - taskDeleted
              - taskPriorityUpdated
              - taskStatusUpdated
              - taskAssigneeUpdated
              - taskDueDateUpdated
              - taskTagUpdated
              - taskMoved
              - taskCommentPosted
              - taskCommentUpdated
              - taskTimeEstimateUpdated
              - taskTimeTrackedUpdated
              - listCreated
              - listUpdated
              - listDeleted
              - folderCreated
              - folderUpdated
              - folderDeleted
              - spaceCreated
              - spaceUpdated
              - spaceDeleted
              - goalCreated
              - goalUpdated
              - goalDeleted
              - keyResultCreated
              - keyResultUpdated
              - keyResultDeleted
              space_id: 1234
              folder_id: 5678
              list_id: 9876
              task_id: abc1234
        required: true
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: CreateWebhookresponse
                required:
                - id
                - webhook
                type: object
                properties:
                  id:
                    type: string
                  webhook:
                    $ref: '#/paths/~1v2~1webhook~1{webhook_id}/put/responses/200/content/application~1json/schema/properties/webhook'
                examples:
                - id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                  webhook:
                    id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                    userid: 183
                    team_id: 108
                    endpoint: https://yourdomain.com/webhook
                    client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                    events:
                    - taskCreated
                    - taskUpdated
                    - taskDeleted
                    - taskPriorityUpdated
                    - taskStatusUpdated
                    - taskAssigneeUpdated
                    - taskDueDateUpdated
                    - taskTagUpdated
                    - taskMoved
                    - taskCommentPosted
                    - taskCommentUpdated
                    - taskTimeEstimateUpdated
                    - taskTimeTrackedUpdated
                    - listCreated
                    - listUpdated
                    - listDeleted
                    - folderCreated
                    - folderUpdated
                    - folderDeleted
                    - spaceCreated
                    - spaceUpdated
                    - spaceDeleted
                    - goalCreated
                    - goalUpdated
                    - goalDeleted
                    - keyResultCreated
                    - keyResultUpdated
                    - keyResultDeleted
                    task_id: null
                    list_id: null
                    folder_id: null
                    space_id: null
                    health:
                      status: active
                      fail_count: 0
                    secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
              example:
                id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                webhook:
                  id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                  userid: 183
                  team_id: 108
                  endpoint: https://yourdomain.com/webhook
                  client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                  events:
                  - taskCreated
                  - taskUpdated
                  - taskDeleted
                  - taskPriorityUpdated
                  - taskStatusUpdated
                  - taskAssigneeUpdated
                  - taskDueDateUpdated
                  - taskTagUpdated
                  - taskMoved
                  - taskCommentPosted
                  - taskCommentUpdated
                  - taskTimeEstimateUpdated
                  - taskTimeTrackedUpdated
                  - listCreated
                  - listUpdated
                  - listDeleted
                  - folderCreated
                  - folderUpdated
                  - folderDeleted
                  - spaceCreated
                  - spaceUpdated
                  - spaceDeleted
                  - goalCreated
                  - goalUpdated
                  - goalDeleted
                  - keyResultCreated
                  - keyResultUpdated
                  - keyResultDeleted
                  task_id: null
                  list_id: null
                  folder_id: null
                  space_id: null
                  health:
                    status: active
                    fail_count: 0
                  secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
      deprecated: false
      security:
      - Authorization_Token: []
    servers:
    - url: https://api.clickup.com/api
      description: ClickUp
      variables: {}
  /v2/webhook/{webhook_id}:
    parameters: []
    put:
      summary: Update Webhook
      tags:
      - Webhooks
      description: Update a webhook to change the events to be monitored.
      operationId: UpdateWebhook
      parameters:
      - name: webhook_id
        in: path
        description: e506-4a29-9d42-26e504e3435e (uuid)
        required: true
        style: simple
        schema:
          type: string
          examples:
          - 4b67ac88
      requestBody:
        description: "To subscribe to specific events, pass an array of `events` that you want to subscribe to, or use the wildcard character `\"*\"` to subscribe to everything.\\\n \\\nIf you don't specify any events, all events will be sent to the webhook."
        content:
          application/json:
            schema:
              title: UpdateWebhookrequest
              required:
              - endpoint
              - events
              - status
              type: object
              properties:
                endpoint:
                  type: string
                events:
                  type: string
                status:
                  type: string
              examples:
              - endpoint: https://yourdomain.com/webhook
                events: '*'
                status: active
            example:
              endpoint: https://yourdomain.com/webhook
              events: '*'
              status: active
        required: true
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: UpdateWebhookresponse
                required:
                - id
                - webhook
                type: object
                properties:
                  id:
                    type: string
                  webhook:
                    title: Webhook
                    required:
                    - id
                    - userid
                    - team_id
                    - endpoint
                    - client_id
                    - events
                    - task_id
                    - list_id
                    - folder_id
                    - space_id
                    - health
                    - secret
                    type: object
                    properties:
                      id:
                        type: string
                      userid:
                        type: integer
                        contentEncoding: int32
                      team_id:
                        type: integer
                        contentEncoding: int32
                      endpoint:
                        type: string
                      client_id:
                        type: string
                      events:
                        type: array
                        items:
                          type: string
                        description: ''
                      task_id:
                        type:
                        - string
                        - 'null'
                      list_id:
                        type:
                        - string
                        - 'null'
                      folder_id:
                        type:
                        - string
                        - 'null'
                      space_id:
                        type:
                        - string
                        - 'null'
                      health:
                        title: Health
                        required:
                        - status
                        - fail_count
                        type: object
                        properties:
                          status:
                            type: string
                          fail_count:
                            type: integer
                            contentEncoding: int32
                        examples:
                        - status: active
                          fail_count: 0
                      secret:
                        type: string
                    examples:
                    - id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                      userid: 183
                      team_id: 108
                      endpoint: https://yourdomain.com/webhook
                      client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                      events:
                      - taskCreated
                      - taskUpdated
                      - taskDeleted
                      - taskPriorityUpdated
                      - taskStatusUpdated
                      - taskAssigneeUpdated
                      - taskDueDateUpdated
                      - taskTagUpdated
                      - taskMoved
                      - taskCommentPosted
                      - taskCommentUpdated
                      - taskTimeEstimateUpdated
                      - taskTimeTrackedUpdated
                      - listCreated
                      - listUpdated
                      - listDeleted
                      - folderCreated
                      - folderUpdated
                      - folderDeleted
                      - spaceCreated
                      - spaceUpdated
                      - spaceDeleted
                      - goalCreated
                      - goalUpdated
                      - goalDeleted
                      - keyResultCreated
                      - keyResultUpdated
                      - keyResultDeleted
                      task_id: null
                      list_id: null
                      folder_id: null
                      space_id: null
                      health:
                        status: active
                        fail_count: 0
                      secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
                examples:
                - id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                  webhook:
                    id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                    userid: 183
                    team_id: 108
                    endpoint: https://yourdomain.com/webhook
                    client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                    events:
                    - taskCreated
                    - taskUpdated
                    - taskDeleted
                    - taskPriorityUpdated
                    - taskStatusUpdated
                    - taskAssigneeUpdated
                    - taskDueDateUpdated
                    - taskTagUpdated
                    - taskMoved
                    - taskCommentPosted
                    - taskCommentUpdated
                    - taskTimeEstimateUpdated
                    - taskTimeTrackedUpdated
                    - listCreated
                    - listUpdated
                    - listDeleted
                    - folderCreated
                    - folderUpdated
                    - folderDeleted
                    - spaceCreated
                    - spaceUpdated
                    - spaceDeleted
                    - goalCreated
                    - goalUpdated
                    - goalDeleted
                    - keyResultCreated
                    - keyResultUpdated
                    - keyResultDeleted
                    task_id: null
                    list_id: null
                    folder_id: null
                    space_id: null
                    health:
                      status: active
                      fail_count: 0
                    secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
              example:
                id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                webhook:
                  id: 4b67ac88-e506-4a29-9d42-26e504e3435e
                  userid: 183
                  team_id: 108
                  endpoint: https://yourdomain.com/webhook
                  client_id: QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO
                  events:
                  - taskCreated
                  - taskUpdated
                  - taskDeleted
                  - taskPriorityUpdated
                  - taskStatusUpdated
                  - taskAssigneeUpdated
                  - taskDueDateUpdated
                  - taskTagUpdated
                  - taskMoved
                  - taskCommentPosted
                  - taskCommentUpdated
                  - taskTimeEstimateUpdated
                  - taskTimeTrackedUpdated
                  - listCreated
                  - listUpdated
                  - listDeleted
                  - folderCreated
                  - folderUpdated
                  - folderDeleted
                  - spaceCreated
                  - spaceUpdated
                  - spaceDeleted
                  - goalCreated
                  - goalUpdated
                  - goalDeleted
                  - keyResultCreated
                  - keyResultUpdated
                  - keyResultDeleted
                  task_id: null
                  list_id: null
                  folder_id: null
                  space_id: null
                  health:
                    status: active
                    fail_count: 0
                  secret: O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA
      deprecated: false
      security:
      - Authorization_Token: []
    delete:
      summary: Delete Webhook
      tags:
      - Webhooks
      description: Delete a webhook to stop monitoring the events and locations of the webhook.
      operationId: DeleteWebhook
      parameters:
      - name: webhook_id
        in: path
        description: e506-4a29-9d42-26e504e3435e (uuid)
        required: true
        style: simple
        schema:
          type: string
          examples:
          - 4b67ac88
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: object
                examples:
                - {}
                contentMediaType: application/json
              example: {}
      deprecated: false
      security:
      - Authorization_Token: []
    servers:
    - url: https://api.clickup.com/api
      description: ClickUp
      variables: {}
  /team/{team_id}/webhook:
    get:
      operationId: getWebhooks
      summary: Get webhooks
      description: Retrieves all webhook subscriptions for a Workspace. Returns webhook details including the endpoint URL, subscribed events, status, and health information.
      tags:
      - Webhooks
      parameters:
      - $ref: '#/components/parameters/teamId'
      responses:
        '200':
          description: Successfully retrieved webhooks
          content:
            application/json:
              schema:
                type: object
                properties:
                  webhooks:
                    type: array
                    items:
                      $ref: '#/components/schemas/Webhook'
        '401':
          description: Unauthorized
      security:
      - bearerAuth: []
    post:
      operationId: createWebhook
      summary: Create a webhook
      description: Creates a new webhook subscription for a Workspace. The webhook can be configured to listen for specific events and send notifications to a specified endpoint URL. A shared secret is returned for signature verification of incoming webhook payloads.
      tags:
      - Webhooks
      parameters:
      - $ref: '#/components/parameters/teamId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWebhookRequest'
      responses:
        '200':
          description: Webhook created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The unique identifier of the webhook.
                  webhook:
                    $ref: '#/components/schemas/Webhook'
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      security:
      - bearerAuth: []
    servers:
    - url: https://api.clickup.com/api/v2
      description: ClickUp API v2 Production Server
  /webhook/{webhook_id}:
    put:
      operationId: updateWebhook
      summary: Update a webhook
      description: Updates an existing webhook subscription. The endpoint URL, subscribed events, and status can be modified.
      tags:
      - Webhooks
      parameters:
      - $ref: '#/components/parameters/webhookId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWebhookRequest'
      responses:
        '200':
          description: Webhook updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The unique identifier of the webhook.
                  webhook:
                    $ref: '#/components/schemas/Webhook'
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '404':
          description: Webhook not found
      security:
      - bearerAuth: []
    delete:
      operationId: deleteWebhook
      summary: Delete a webhook
      description: Permanently deletes a webhook subscription. ClickUp will stop sending events to the endpoint URL immediately.
      tags:
      - Webhooks
      parameters:
      - $ref: '#/components/parameters/webhookId'
      responses:
        '200':
          description: Webhook deleted successfully
        '401':
          description: Unauthorized
        '404':
          description: Webhook not found
      security:
      - bearerAuth: []
    servers:
    - url: https://api.clickup.com/api/v2
      description: ClickUp API v2 Production Server
components:
  schemas:
    Webhook:
      type: object
      description: A webhook subscription object.
      properties:
        id:
          type: string
          description: The unique identifier of the webhook.
        userid:
          type: integer
          description: The user ID who created the webhook.
        team_id:
          type: integer
          description: The Workspace ID the webhook belongs to.
        endpoint:
          type: string
          format: uri
          description: The URL that ClickUp sends event payloads to.
        client_id:
          type: string
          nullable: true
          description: The OAuth client ID if the webhook was created via OAuth.
        events:
          type: array
          items:
            type: string
            enum:
            - taskCreated
            - taskUpdated
            - taskDeleted
            - taskPriorityUpdated
            - taskStatusUpdated
            - taskAssigneeUpdated
            - taskDueDateUpdated
            - taskTagUpdated
            - taskMoved
            - taskCommentPosted
            - taskCommentUpdated
            - taskTimeEstimateUpdated
            - taskTimeTrackedUpdated
            - listCreated
            - listUpdated
            - listDeleted
            - folderCreated
            - folderUpdated
            - folderDeleted
            - spaceCreated
            - spaceUpdated
            - spaceDeleted
            - goalCreated
            - goalUpdated
            - goalDeleted
            - keyResultCreated
            - keyResultUpdated
            - keyResultDeleted
          description: The events the webhook is subscribed to.
        task_id:
          type: string
          nullable: true
          description: Optional task ID to scope webhook events to a specific task.
        list_id:
          type: integer
          nullable: true
          description: Optional list ID to scope webhook events to a specific list.
        folder_id:
          type: integer
          nullable: true
          description: Optional folder ID to scope webhook events to a specific folder.
        space_id:
          type: integer
          nullable: true
          description: Optional space ID to scope webhook events to a specific space.
        health:
          type: object
          properties:
            status:
              type: string
              description: The health status of the webhook (active, failing, etc.).
            fail_count:
              type: integer
              description: Number of consecutive failures.
          description: Health status of the webhook.
        secret:
          type: string
          description: The shared secret for HMAC-SHA256 signature verification. Only returned when the webhook is first created.
    CreateWebhookRequest:
      type: object
      required:
      - endpoint
      - events
      description: Request body for creating a new webhook subscription.
      properties:
        endpoint:
          type: string
          format: uri
          description: The URL to send webhook event payloads to.
        events:
          type: array
          items:
            type: string
          description: Array of event names to subscribe to. Use '*' to subscribe to all events.
        task_id:
          type: string
          description: Optional task ID to scope webhook events to a specific task.
        list_id:
          type: integer
          description: Optional list ID to scope webhook events to a specific list.
        folder_id:
          type: integer
          description: Optional folder ID to scope webhook events to a specific folder.
        space_id:
          type: integer
          description: Optional space ID to scope webhook events to a specific space.
    UpdateWebhookRequest:
      type: object
      description: Request body for updating an existing webhook subscription.
      properties:
        endpoint:
          type: string
          format: uri
          description: The updated endpoint URL.
        events:
          type: array
          items:
            type: string
          description: Updated array of event names to subscribe to.
        status:
          type: string
          enum:
          - active
          - inactive
          description: Set the webhook status to active or inactive.
  parameters:
    webhookId:
      name: webhook_id
      in: path
      required: true
      description: The unique identifier of the webhook.
      schema:
        type: string
    teamId:
      name: team_id
      in: path
      required: true
      description: The unique identifier of the Workspace (team).
      schema:
        type: integer
  securitySchemes:
    Authorization_Token:
      name: Authorization
      type: apiKey
      in: header
      description: 'API token required for authentication. Two types of tokens are supported:

        **Personal API Key** Obtain from ClickUp''s settings page under ''Apps'' and add it to the header as `Authorization: pk_...`

        **OAuth2 Access Token** Generated through the OAuth2 flow and add it to the header as `Authorization: Bearer {access_token}`'
    bearerAuth:
      type: http
      scheme: bearer
      description: ClickUp personal API token or OAuth access token.
externalDocs:
  description: ClickUp Webhooks Documentation
  url: https://developer.clickup.com/docs/webhooks
x-refined-from:
- clickup-api-v2-reference-openapi.json
- clickup-webhooks-openapi.yml