Skip to main content
POST
Partially updates an existing webhook subscription. This is a patch-style operation — only fields you include in the request body are modified; any field you omit (or send as null) retains its current value. At least one field must be provided. You can use this endpoint to change the callback URL, update the event list, toggle the subscription on or off, or update the description.
The source API uses POST (not PUT) for this update operation. Use the path POST /public/webhook/subscription/{SubscriptionId}.

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 update. Must belong to the authenticated account; returns 400 if not found.

Body

application/x-www-form-urlencoded
Url
string

New HTTPS URL for the webhook endpoint. Must use the https:// scheme and resolve to a publicly routable host — private, loopback, and link-local addresses are rejected. Omit (null) to keep the current URL.

Description
string

New human-readable label for this subscription. Send an empty string to clear the current description. Omit (null) to keep the current value. Trimmed before storage.

Enabled
boolean

When false, the subscription is paused and no events will be delivered until re-enabled. Omit to leave the current state unchanged.

Events
string[]

Replacement list of event-type names. When provided, completely replaces the existing event list. Omit to leave the current list unchanged.

Response

Success

Webhook subscription returned by the public webhook management API

subscriptionId
integer<int64>
required

Unique numeric identifier of the webhook subscription

url
string
required

HTTPS URL that receives webhook POST deliveries

enabled
boolean
required

Whether the subscription is enabled

events
string[]
required

Event names that trigger this subscription

description
string

Optional human-readable label for the subscription

secretKey
string

Signing secret used to verify webhook deliveries. Only returned when a new secret is issued, such as during create or update operations