post
https://production-api.shoutaboutus.com/api/v1/partner/webhooks//update
Partially updates a subscription owned by the caller's partner — every field is optional; send only what changes. The HMAC secret cannot be changed here (use rotate-secret). delivery_kind may be switched but must not collide with the partner's other slot. Returns the updated row (no secret).
Auth: Partner — authentication; findCallerSubscription enforces bundle_id === 1 and scopes by partner_company_id (404 if not owned).
Rate limit: No rate limit.
Request
- Body (all
sometimes):
| Field | Type | Required | Notes |
|---|---|---|---|
label | string | no | sometimes+required when present; max 255 |
webhook_url | string (url) | no | url:http,https, max 2048 |
is_active | bool | no | enable/disable |
delivery_kind | string | no | immediate | batch; unique-slot rule excludes the edited row by id — 422 on collision with the other slot |
batch_interval_hours | int|null | required if delivery_kind=batch | one of [1,2,4,6,12] |
events | array | no | null/[] = all events; on immediate effective kind, batch-kind events rejected; hipages events rejected for non-hipages partners |
events.* | string | — | Must be one of the event names from the events catalog (GET /api/v1/partner/webhooks/events). |
payload_mode | string | no | full | minimal |
Response — { data: { data: {.} } } envelope (HTTP 200). Same presenter fields as Show one subscription, without hmac_secret.
Path params
| Parameter | Type | Required | Notes |
|---|---|---|---|
webhookSubscriptionId | integer | Required | Digits only. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…