Skip to content
Docs
APISign inStart free

Delete a webhook endpoint

The webhook_endpoints.delete operation: DELETE /api/v1/webhook_endpoints/{id} in the REST API and the webhook_endpoints_delete tool in the MCP server.

DELETE/api/v1/webhook_endpoints/{id}

Deletes an endpoint and its signing secret for good. Nothing more is sent to it: deliveries waiting for a retry are canceled instead of sent. Its delivery log stays readable with webhook_deliveries.list. To pause an endpoint instead, set enabled: false with webhook_endpoints.update.

At a glance

  • REST: DELETE /api/v1/webhook_endpoints/{id}
  • MCP tool: webhook_endpoints_delete
  • Operation ID: webhook_endpoints.delete
  • Scope: Brand
  • Permission: webhooks:admin
  • Risk tier: security
  • Dry run: Supported (send Ownrecord-Dry-Run: true)
  • Idempotency: Idempotency-Key optional
  • Modes: Test and live
  • Authentication: API key with the webhooks:admin scope
  • Since: M4

Request

Path parameters

FieldTypeDescription
idwe_… ID

Body

This operation takes no body.

Response

200 OK with a JSON object:

FieldTypeDescription
idwe_… ID
object"webhook_endpoint"
deletedtrue

Examples

Delete an endpoint

HTTP
DELETE /api/v1/webhook_endpoints/we_01m4tx5nj8emwbyf7y9vcf47z0
Authorization: Bearer or_test_…

Response (200):

JSON
{
  "id": "we_01m4tx5nj8emwbyf7y9vcf47z0",
  "object": "webhook_endpoint",
  "deleted": true
}

Errors

CodeHTTP statusWhenWhat to do
resource_not_found404No endpoint with this ID is visible to the request.Check the ID and that your credentials are scoped to the right organization, entity, brand and mode.
version_conflict409The endpoint changed at the same time; retry.Fetch the object again and retry the change.
permission_denied403You can't manage this brand's webhooks.Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, invalid_json, unsupported_media_type, authentication_required, api_key_invalid, scope_required, idempotency_key_reused, idempotency_in_progress, approval_required, approval_rejected, approval_expired, stale_approval, approval_policy_denied, rate_limited, internal_error.