---
title: "Edit Webhooks"
method: POST
path: "/v2/webhook/{webhookId}"
tags: ["Webhook"]
---

# Edit Webhooks

`POST /v2/webhook/{webhookId}`

Edit Webhooks

## Path parameters

- `webhookId` string, required

## Request body

- RegisterPublicWebhookDtoV2
  - `url` string, uri, required — URL of the webhook
  - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD', required — HTTP method used for the webhook
  - `headers` object — Custom headers to be sent with the webhook
  - `body` object — Payload to be sent with the webhook
  - `query` object — Query parameters to be included in the webhook URL
  - `bodyFormat` 'JSON' | 'FORM_DATA' — Format of the body content
  - `authorization` object — Authorization details for the webhook
    - `type` 'BASIC' | 'BEARER', required — The type of authorization used for the webhook
    - `payload` string, required — The authorization payload, such as a token or credentials
  - `webhookEvents` string[], required — Events that trigger the webhook
  - `retryOnTimeout` boolean — Retry the webhook call on timeout
  - `name` string, required — Name of the webhook
  - `wabaNumbers` string[], required — List of WABA numbers associated with the webhook

## Response `201`

Edit Webhook

- RegisterPublicWebhookResponseV2
  - `validWebhooks` PublicWebhook[], required — A list of valid webhooks
    - `wabaNumber` string, required — The WABA (WhatsApp Business Account) number associated with the webhook
    - `webhookEventType` 'MESSAGE_RECEIVED' | 'MESSAGE_STATUS_UPDATE' | 'CHAT_ASSIGNED_TO_AGENT' | 'ASSIGNED_AGENT_STATUS_CHANGED' | 'CHAT_UNASSIGNED' | 'UPDATE_CUSTOMER_CUSTOM_FIELD' | 'WIDGET_LEAD_RECEIVED' | 'VERIFIED_WIDGET_LEAD_RECEIVED' | 'NEW_LEAD' | 'RAW_CLOUD_API_WEBHOOK' | 'CLOSE_CONVERSATION' | 'TEMPLATE_UPDATE' | 'ADD_TAG' | 'REMOVE_TAG' | 'CALL_TO_WHATSAPP_MESSAGE_RECEIVED' | 'CONVERSATION_OPENED' | 'CUSTOMER_BUSINESS_CHAT_OPEN', required — The type of event that triggers the webhook
  - `invalidWebhooks` PublicWebhook[], required — A list of invalid webhooks
    - `wabaNumber` string, required — The WABA (WhatsApp Business Account) number associated with the webhook
    - `webhookEventType` 'MESSAGE_RECEIVED' | 'MESSAGE_STATUS_UPDATE' | 'CHAT_ASSIGNED_TO_AGENT' | 'ASSIGNED_AGENT_STATUS_CHANGED' | 'CHAT_UNASSIGNED' | 'UPDATE_CUSTOMER_CUSTOM_FIELD' | 'WIDGET_LEAD_RECEIVED' | 'VERIFIED_WIDGET_LEAD_RECEIVED' | 'NEW_LEAD' | 'RAW_CLOUD_API_WEBHOOK' | 'CLOSE_CONVERSATION' | 'TEMPLATE_UPDATE' | 'ADD_TAG' | 'REMOVE_TAG' | 'CALL_TO_WHATSAPP_MESSAGE_RECEIVED' | 'CONVERSATION_OPENED' | 'CUSTOMER_BUSINESS_CHAT_OPEN', required — The type of event that triggers the webhook
  - `invalidWabaNumbers` string[], required — A list of invalid WABA numbers

## Other responses

- `400` — Incorrect payload
- `401` — Unauthorized

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)