Skip to main content
PATCH
/
api
/
v1
/
webhooks
/
subscriptions
/
{subscription_id}
curl --request PATCH \
  --url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions/7c1d2e3f-... \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "active": false
  }'

{
    "id": "7c1d2e3f-...",
    "application_id": "2e35e07e-...",
    "target_url": "https://example.com/webhooks/hostpay",
    "events": ["deposit.completed", "payout.failed"],
    "active": true,
    "ip_allowlist": null,
    "payload_version": "2025-01",
    "secret_preview": "...k3Qz",
    "created_at": "2026-07-04T10:30:00Z",
    "updated_at": "2026-07-04T10:30:00Z"
  }
Partial update: send only the fields to change. Use active: false to pause deliveries without deleting the subscription.

​
Path Parameters

​
subscription_id
string
required
The subscription to update.

​
Request Body

​
target_url
string
New delivery endpoint (HTTPS; internal/private addresses rejected).
​
events
string[]
Replace the subscribed event types.
​
active
boolean
Enable or pause deliveries.
​
ip_allowlist
string[]
Replace the source-IP allowlist.
​
payload_version
string
Change the payload schema version.

​
Response

The updated subscription, same shape as list subscriptions. 
{
    "id": "7c1d2e3f-...",
    "application_id": "2e35e07e-...",
    "target_url": "https://example.com/webhooks/hostpay",
    "events": ["deposit.completed", "payout.failed"],
    "active": true,
    "ip_allowlist": null,
    "payload_version": "2025-01",
    "secret_preview": "...k3Qz",
    "created_at": "2026-07-04T10:30:00Z",
    "updated_at": "2026-07-04T10:30:00Z"
  }

curl --request PATCH \
  --url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions/7c1d2e3f-... \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "active": false
  }'