Skip to main content
DELETE
Delete webhook
Deletes a webhook endpoint. This action is PERMANENT. The webhook will stop receiving events immediately.

Authentication

This endpoint requires authentication via Bearer token:
  • Authorization: Bearer <token>

Path Parameters

Permissions

Only OWNERS and ADMINS can delete webhooks.

What Happens

When a webhook is deleted:
  • Webhook is permanently removed
  • No more events will be sent to this URL
  • The webhook will stop receiving events immediately
  • This action cannot be undone

Example Request

Example Response

A successful deletion returns no response body, only a 204 status code.

Common Errors

401 Unauthorized

Authentication required.

403 Forbidden

Only owners and admins can delete webhooks.

404 Not Found

The webhook does not exist, or it belongs to another organization.

Best Practices

Before deleting a webhook:
  1. Disable it first - Set isActive: false to test without deleting
  2. Check delivery history - Review recent deliveries
  3. Notify your team - Coordinate with developers using this webhook
  4. Document the change - Keep track of why it was removed

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required
id
string
required

Response

Webhook deleted successfully. Webhook will no longer receive events.