https://demo.notifuse.com/api/webhookSubscriptions.update Updates an existing webhook subscription with new configuration.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Body application/json
The ID of the workspace
The ID of the subscription to update
Updated name
Updated URL
Updated list of event types
Filters for the custom_event.* events. Omit it to leave the stored filters unchanged; send an empty object to stop filtering custom events.
Show 2 child attributes Hide 2 child attributes
Filter by goal type (e.g., purchase, subscription, lead)
Filter by event name (e.g., orders/fulfilled, payment.succeeded)
Lists the list.* events are narrowed to. Omit it to leave the stored filter unchanged — a body that never mentions it cannot widen the subscription — and send an empty array to remove the narrowing.
Segments the segment.* events are narrowed to. Omit it to leave the stored filter unchanged; send an empty array to remove the narrowing.
Whether the subscription is enabled. Omit it to leave the stored value unchanged; send it only to switch the subscription on or off.
Response
200 Webhook subscription updated successfully object
A webhook subscription that receives HTTP callbacks when events occur
Show 13 child attributes Hide 13 child attributes
Unique identifier for the subscription
Human-readable name for the subscription
The HTTPS URL to receive webhook events
Secret key for signing webhook payloads (Standard Webhooks spec)
Settings for webhook subscription
Show 4 child attributes Hide 4 child attributes
List of event types this subscription is subscribed to
Optional filters for custom_event.* event types
Show 2 child attributes Hide 2 child attributes
Filter by goal type (e.g., purchase, subscription, lead)
Filter by event name (e.g., orders/fulfilled, payment.succeeded)
Lists the list.* events are narrowed to. Absent or empty means every list.
Segments the segment.* events are narrowed to. Absent or empty means every segment.
List of event types this subscription is subscribed to (flattened from settings for convenience)
Optional filters for custom_event.* event types (flattened from settings for convenience)
Show 2 child attributes Hide 2 child attributes
Filter by goal type (e.g., purchase, subscription, lead)
Filter by event name (e.g., orders/fulfilled, payment.succeeded)
Lists the list.* events are narrowed to (flattened from settings for convenience). Absent or empty means every list.
Segments the segment.* events are narrowed to (flattened from settings for convenience). Absent or empty means every segment.
Whether the subscription is currently active
Timestamp of the last delivery attempt
When the subscription was created
When the subscription was last updated
400 Bad request - validation failed object
Error message
401 Unauthorized - invalid or missing authentication token object
Error message
404 Webhook subscription not found object
Error message
500 Internal server error object
Error message