Api referenceWebhooks
Delete Webhook
Permanently delete a webhook
Authentication
Account API Key required via Authorization: Bearer {api_key} header.
Path Parameters
idstringpathrequiredWebhook 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
successbooleanAlways true on successful deletion
idstringID of the deleted webhook
Error Responses
401errorInvalid or missing API key
404errorWebhook 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
PATCHwithstatus: "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.