Webhooks

Delete Webhook

Delete a specific webhook endpoint by its unique identifier.

Request Parameters:

  • webhook_id: Unique identifier of the webhook to delete (path parameter)

Response Behavior:

  • Successfully deletes the webhook and returns a confirmation message
  • Returns 404 if webhook doesn't exist or user doesn't have access
  • Returns 500 for internal server errors

Security:

  • Only the webhook owner can delete their webhook
  • Webhook ID must be a valid MongoDB ObjectId format
  • Requires valid authentication token

Use Cases:

  • Remove unused webhook endpoints
  • Clean up webhook configurations
  • Disable event notifications for specific URLs
  • Maintain webhook hygiene and security

Important Notes:

  • This action is irreversible - deleted webhooks cannot be recovered
  • All webhook event subscriptions are immediately terminated
  • No events will be sent to the deleted webhook URL
  • Consider temporarily disabling webhooks instead of deletion for testing

Error Handling:

  • 404: Webhook not found or access denied
  • 500: Internal server error with detailed error information
delete/api/v1/webhooks/{webhook_id}

Path parameters

webhook_idstring required

Response

Webhook deleted successfully

successboolean

Operation success status - always true for successful responses

messagestring required

Success message confirming webhook deletion

Changes

No recorded changes to this endpoint across all 1 revision of this API.