---
title: "PATCH /public/v1/webhooks/{id}"
method: PATCH
path: "/public/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# PATCH /public/v1/webhooks/{id}

`PATCH /public/v1/webhooks/{id}`

Update a webhook. Only the fields you send are changed. triggerTypes replaces the full list. enabled=false pauses delivery without deleting the webhook; enabled=true resumes it. WORKSPACE webhooks require ADMIN/OWNER.

## Path parameters

- `id` string, required

## Request body

- object
  - `label` string
  - `webhookUrl` string — New absolute http(s) endpoint.
  - `triggerTypes` string[] — Events that fire this webhook. PROSPECT_RESPONSE and SEND_FIRST_PROSPECT_RESPONSE are mutually exclusive; if both are sent only PROSPECT_RESPONSE is kept.
  - `payloadFields` object — Optional payload opt-ins (extra fields to include in the delivered JSON). null clears them.
    - `include_icp_fit` boolean
    - `include_icp_fit_justification` boolean
    - `include_template_name` boolean
    - `include_subject` boolean
    - `include_message_type` boolean
    - `include_message_index` boolean
    - `include_file_upload_data` boolean
    - `first_prospect_response_inmail_only` boolean
    - `warm_list_min_icp_fit` 'HIGH' | 'MEDIUM' | 'LOW'
  - `enabled` boolean — false pauses delivery, true resumes it.

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `webhook` object
      - `id` string
      - `label` unknown
      - `scope` 'PERSONAL' | 'WORKSPACE'
      - `webhookUrl` string
      - `triggerTypes` string[]
      - `payloadFields` unknown
      - `isActive` boolean — false = paused; nothing is delivered until re-enabled.
      - `createdByUserId` string
      - `workspaceId` unknown
      - `createdAt` string
      - `lastUsedAt` unknown

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `429` — Default Response
- `500` — Default Response

## Changes

- **2026-10-06** `16d733866b5a` — 1 info
  - added the new `ADDED_TO_DNC` enum value to the request property `triggerTypes/items/`
- **2026-09-09** `8997574763c0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/joinvalley/apis/valley-public-api/changes/public/v1/webhooks/:id/patch.md)

---

[API](https://skmtc.dev/joinvalley/apis/valley-public-api.md) · [All operations](https://skmtc.dev/joinvalley/apis/valley-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinvalley/apis/valley-public-api/revisions/16d733866b5a?raw)