Skip to main content
DELETE
/
v1
/
webhooks
/
endpoints
/
{endpointId}
Delete Webhook Endpoint
curl --request DELETE \
  --url https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints/{endpointId} \
  --header 'x-api-key: <api-key>'
This endpoint requires HMAC-SHA256 authentication. See Authentication for signature computation details.

​
Permanent Deletion

Deleting a webhook endpoint is permanent and cannot be undone. All configuration including:
  • The endpoint URL
  • Event subscriptions
  • Custom metadata
  • The signing secret
…will be permanently removed.
If you need to temporarily stop receiving webhooks, consider updating the endpoint to set status: "disabled" instead of deleting it.

​
Response

A successful deletion returns 204 No Content with no response body.

​
Impact on Payment Processing

Deleting your last webhook endpoint will cause payments with webhookMode: true to fail with NO_WEBHOOK_ENDPOINTS error. Ensure you have at least one active endpoint if you’re using webhook mode for payments.

Authorizations

​
x-api-key
string
header
required

HMAC-SHA256 authentication. Requires three headers: x-api-key (your API key), x-timestamp (ISO 8601 timestamp), and x-signature (Base64-encoded HMAC-SHA256 signature). See Authentication documentation for signature computation.

Path Parameters

​
endpointId
string
required

The unique identifier of the webhook endpoint

Response

Webhook endpoint deleted successfully