Delete a webhook

Permanently removes a webhook from the system, stopping all future event notifications.

Business Context: Webhook deletion is typically performed when integrations are being decommissioned, endpoints are no longer valid, or webhook configurations need to be completely rebuilt.

Deletion Impact:

• Immediate Effect: Webhook stops receiving events immediately
• Permanent Action: Cannot be undone - webhook must be recreated if needed
• Event History: Past webhook deliveries remain in logs for audit purposes
• No Notifications: No events will be sent to the deleted webhook URL

When to Delete Webhooks:

• Integration Decommission: Removing old or unused integrations
• Endpoint Changes: When webhook URLs are permanently changing
• Security Incidents: Compromised endpoints requiring immediate removal
• Configuration Errors: Starting over with clean webhook setup
• Partner Offboarding: Removing webhooks for departed partners

Alternative Actions:

• Disable Instead: Use PATCH to set enabled: false for temporary suspension
• Update Configuration: Use PATCH to modify URL, events, or settings
• Event Filtering: Modify event subscriptions without deletion

Best Practices:

• Backup Configuration: Record webhook settings before deletion
• Gradual Migration: Disable before deleting when migrating endpoints
• Monitor Impact: Verify downstream systems handle the removal properly
• Documentation: Update integration documentation after deletion

Common Use Cases:

• Cleaning up test or development webhooks
• Removing webhooks for decommissioned services
• Resolving webhook delivery failures permanently
• Consolidating multiple webhooks into single endpoints
• Partner relationship termination cleanup

Integration Cleanup: After deletion, ensure downstream systems are updated to remove dependencies on webhook notifications from this endpoint.