Skip to main content
DELETE
/
v1
/
webhooks
/
{id}
Delete Webhook
curl --request DELETE \
  --url https://api.example.com/v1/webhooks/{id}
{
  "data": {
    "deleted": true,
    "id": "<string>"
  }
}

Request

Path Parameters

id
string
required
The webhook’s unique ID (UUID)

Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the webhooks:write permission.
Deletion is permanent and cannot be undone. The signing secret is immediately invalidated and any in-flight retries will be cancelled. Historical delivery logs remain available for 30 days via the audit log.

Response

data
object
curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/webhooks/7f3c4d2a-1b8e-4a9c-9d6f-2e5b8c7a1f3d \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "deleted": true,
    "id": "7f3c4d2a-1b8e-4a9c-9d6f-2e5b8c7a1f3d"
  }
}
To rotate a compromised signing secret, delete the webhook and create a new one with the same URL and events.

Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing webhooks:write permission
404webhook_not_foundNo webhook with this ID in your workspace
429rate_limitedRate limit exceeded