API Reference
API Reference / Endpoints / Platform

Disable a webhook destination

/v1/webhooks/:webhookId

Disable a webhook destination without removing its historical deliveries.

DELETE/v1/webhooks/:webhookId
Auth: API keyBilling: FreeBehavior: SyncScopes: webhooks:manage
DELETESyncNo bodywebhooks:manage

When to use it

Use this when you want to stop future deliveries cleanly while preserving the registration record for audit or later review.

Behavior on success

Returns a completed payload on the normal success path.

Integration shape

Authorization model
webhooks:manage
Request format
No request body
Polling pattern
No polling required on the normal success path.

Request

FieldTypeRequiredDescription
webhookIdstringYesWebhook identifier returned at creation time.

Example request

DELETE /v1/webhooks/:webhookId
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/webhooks/wh_123', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
  },
});

const payload = await response.json();
console.log(payload);

Example response

Response shapejson
{
  "success": true,
  "data": {
    "webhook_id": "wh_123",
    "is_active": false
  }
}

Production guidance

Pair this route with idempotency on POST requests and either request polling or webhooks whenever the response is asynchronous.
Was this page helpful?
Previous
Create API keyNext