Skip to main content
DELETE
/
public
/
webhook
/
unsubscribe
/
{SubscriptionId}
curl -i -X DELETE \
  'https://api.portal.io/public/webhook/unsubscribe/42' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'

{
  "success": true,
  "subscriptionId": 42
}
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.
curl -i -X DELETE \
  'https://api.portal.io/public/webhook/unsubscribe/42' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'

{
  "success": true,
  "subscriptionId": 42
}

Headers

​
Accept
enum<string>
required

Accept Header

Available options:
application/json
​
X-MSS-API-APPID
string
required

Application Id

​
X-MSS-CUSTOM-DATE
string
required

A date timestamp of the request

​
X-MSS-SIGNATURE
string
required

A signature for the request

​
X-MSS-API-USERKEY
string
required

User API Key

Path Parameters

​
SubscriptionId
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