Skip to content

Delete a webhook

post/delete-webhook
Any keyDeletes

Delete the webhook registered with the given URL, together with all of its event subscriptions. The response lists the chatbot's remaining webhooks. If no webhook matches url, nothing is deleted and the response is still 200 with the unchanged list.

Request body

Sending 2 of 2 fields
Required
chatbotIdstring
The ID of the chatbot the webhook belongs to.
urlstring
The URL endpoint that the chatbot delivers events to.

Only these fields are sent (application/json).

Try it · POST /delete-webhook
curl 'https://api.chat-data.com/api/v2/delete-webhook' \  -H "Authorization: Bearer $CHAT_DATA_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "chatbotId": "6650f1c2a9e4b83d2c7a1f05",  "url": "https://example.com/webhooks/chat-data"}'
Loading…

Responses

Successful response.

Content type: application/json

FieldDescription
statusstringOne of: success.
webhooksarray of objectThe chatbot's webhooks after the change.
webhooks[].endpointstringThe URL endpoint that the chatbot delivers events to.
webhooks[].eventsarray of stringAn array of events that the webhook subscribes to. See Webhooks for the event bodies.
webhooks[].secretstringThe secret used to sign deliveries. The x-chat-data-hmac-sha256 header carries the Base64 HMAC-SHA256 of the raw request body, keyed with this secret.
webhooks[].enablebooleanIndicates whether the webhook is turned on.
webhooks[].contentTypestringThe Content-Type of the deliveries. One of: text/plain, application/json.

Example

{  "status": "success",  "webhooks": [    {      "endpoint": "https://example.com/webhooks/chat-data",      "events": [        "chat"      ],      "secret": "4f9a2c7e1b8d3f6a0c5e9b2d7a1f4c8e3b6d9f2a5c8e1b4d7f0a3c6e9b2d5f8a",      "enable": true,      "contentType": "text/plain"    }  ]}

Last updated October 14, 2026