Delete Webhook

Deletes a webhook by its UUID. This endpoint permanently removes the webhook configuration and stops all future event notifications to the associated URL.

HTTP Method and URL

DELETE {{host}}/api/v2/webhooks/:uuid

Authentication Requirements

Requires a valid user-token (Bearer token) in the request headers.

Path Parameters

Request Body

None. This endpoint does not require a request body.

Example Request

DELETE {{host}}/api/v2/webhooks/abc123-def456-ghi789
Authorization: Bearer {USER-TOKEN}

Example Successful Response

{
  "success": true,
  "message": "Webhook deleted successfully."
}

Error Responses

• 401 Unauthorized: Missing or invalid authentication token.

• 404 Not Found: Webhook with the specified UUID does not exist.

• 500 Internal Server Error: Unexpected server error.

Usage Notes

• The user-token variable should be set in your environment or as a global variable.

• The webhook-uuid variable should contain the UUID of the webhook you want to delete.

• Warning: This action is irreversible. Once deleted, the webhook cannot be recovered.

• Use the "Get All Webhooks" endpoint first to obtain the UUID of the webhook you want to delete.

• Consider using the "Update Webhook" endpoint to set the status to inactive instead of deleting if you may need the webhook again in the future.