Skip to main content
Deleting a webhook performs a soft delete: the webhook record is retained for audit purposes but immediately stops receiving event deliveries. Once deleted, the webhook’s status becomes DELETED and any subsequent request to its id returns 410 Gone. This action cannot be undone — if you want to temporarily pause delivery without permanent removal, use the Update Webhook endpoint to set status to DISABLED instead. This endpoint requires the webhooks:write permission.

​
Request

DELETE https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks/{id}

​
Headers

​
Authorization
string
required
Bearer token using your API key. Format: Bearer cs_live_your_key

​
Path parameters

​
id
string
required
The unique identifier of the webhook to delete (e.g., wh_01hx4kz9mntd8vr2bpqe5ycf3a).

​
Response

​
200 — success

​
message
string
Human-readable confirmation that the webhook was deleted.
​
webhookId
string
The identifier of the webhook that was deleted.
​
status
string
Always "DELETED" on a successful response.

​
401 — unauthorized

Returned when your API key is missing, invalid, or lacks the webhooks:write permission.

​
404 — not found

Returned when no webhook with the given id exists under your merchant account.

​
410 — gone

Returned when the webhook was already deleted in a previous request. Once a webhook is deleted, all subsequent requests to that id return 410 Gone.

​
Example

curl -X DELETE https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks/wh_01hx4kz9mntd8vr2bpqe5ycf3a \
  -H "Authorization: Bearer cs_live_your_key"
Sample response (200)
{
  "message": "Webhook deleted successfully",
  "webhookId": "wh_01hx4kz9mntd8vr2bpqe5ycf3a",
  "status": "DELETED"
}
Deletion is permanent. Any application logic relying on this webhook will stop receiving events immediately. Register a new webhook if you need to restore delivery to the same endpoint.