Skip to main content
DELETE
Permanently deletes a webhook subscription and all of its event bindings. Once deleted, Portal.io will no longer send event payloads to the associated endpoint. This action cannot be undone — if you need to re-subscribe later, you must create a new subscription with POST /public/webhook/subscribe.
Deletion is immediate and permanent. Ensure you want to stop all deliveries before calling this endpoint.

Authorizations

X-MSS-API-APPID
string
header
required

Portal application identifier used as part of HMAC-authenticated API requests.

X-MSS-API-USERKEY
string
header
required

Portal user API key used together with the HMAC signature headers.

X-MSS-CUSTOM-DATE
string
header
required

Timestamp header included in the signed request to prevent replay attacks.

X-MSS-SIGNATURE
string
header
required

HMAC-SHA256 signature for the request, calculated over the canonical string defined in the authentication docs.

Headers

Accept
enum<string>
required

Accept Header

Available options:
application/json

Path Parameters

SubscriptionId
null | integer<int64>
required

Numeric ID of the webhook subscription to permanently delete. Must belong to the authenticated account; returns 400 if not found.

Response

Success

Result of deleting a public webhook subscription

success
boolean
required

Always true for a successful delete response

subscriptionId
integer<int64>
required

Identifier of the deleted webhook subscription