GetOTP Documentation

Delete Webhook

The Webhooks API provides a way to delete your Webhooks.

Request for Delete Webhook API

To delete a Webhook, make a DELETE request to our Webhook endpoint.

https://api.otp.dev/v1/webhooks/{webhook_id}

With the following Basic HTTP verification method:

With the following parameter:

Examples

Below is an example request using cURL:

curl --request DELETE \
    --url https://api.otp.dev/v1/webhooks/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
    --header 'X-OTP-Key: {YOUR_API_KEY}'

The response would be returned with HTTP 204status code:

If there is an error with the API call, you will receive a JSON response with 400+ status code, error code and message.

{
    "errors": [{
        "timestamp": "2025-08-18 00:00:00",
        "path": "/v1/webhooks/3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "method": "PUT",
        "status": 404,
        "message": "Webhook not found",
        "code": "1201"
    }]
}

Please refer to this table for details: