daimon.email
Api referenceWebhooks

Delete Webhook

Permanently delete a webhook

Authentication

Account API Key required via Authorization: Bearer {api_key} header.

Path Parameters

idstringpathrequired

Webhook ID (prefix: wh_)

curl -X DELETE https://api.daimon.email/v1/webhooks/wh_xyz789 \
  -H "Authorization: Bearer dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o"
import { DaimonClient } from 'daimon-email';

const client = new DaimonClient({
  apiKey: 'dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o'
});

const result = await client.webhooks.delete('wh_xyz789');

if (result.success) {
  console.log(`Webhook ${result.id} deleted`);
}
from daimon_email import DaimonClient

client = DaimonClient(api_key='dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o')

result = client.webhooks.delete('wh_xyz789')

if result.success:
    print(f"Webhook {result.id} deleted")

Response

{
  "result": {
    "success": true,
    "id": "wh_xyz789"
  },
  "next_steps": [
    "Webhook has been permanently deleted",
    "No further events will be delivered to this endpoint",
    "Use POST /v1/webhooks to create a new webhook if needed"
  ]
}

Response Fields

successboolean

Always true on successful deletion

idstring

ID of the deleted webhook

Error Responses

401error

Invalid or missing API key

404error

Webhook not found or does not belong to this account

Behavior

  • Deletion is immediate and permanent
  • No events will be delivered after deletion
  • The webhook ID cannot be reused
  • There is no "soft delete" - use PATCH with status: "disabled" if you want to temporarily pause delivery

Warning

Permanent action: Deletion cannot be undone. If you need to temporarily stop receiving events, use PATCH /v1/webhooks/{id} with status: "disabled" instead.

Info

Recreating webhooks: If you delete and recreate a webhook with the same URL, a new secret will be generated. Update your signature verification code accordingly.