Delete a webhook subscription

DELETE

/v1/webhooks/{id}

Permanently removes a webhook subscription — deliveries stop immediately. Returns 200 with { id, deleted: true }. An id that does not exist or belongs to another org → 404 not_found (so a repeated DELETE is a safe 404). To pause without deleting, PATCH active: false instead.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Subscription deleted

Bodyapplication/json

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.mailfloss.com/v1/webhooks/' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "aBcDeFgHiJkLmNoPq",
    "deleted": true
}

Modified at 2026-10-20 13:54:45

Update a webhook subscription

List all integrations (connected + disconnected)