Skip to main content
Updates an active webhook subscription. At least one of url or events must be provided. When events is sent, it replaces the full set of subscribed event types — it is not additive.

​
Request body fields

​
Example: change URL only

​
Example: replace subscribed events

​
Example: replace with a wildcard

Subscribe to every event in a family by using a <namespace>.* wildcard. Wildcards work for all event families (transfer.*, payment.*, account.*, etc.).

​
Error responses

  • 400 — empty patch body (no fields provided).
  • 404 — subscription not found or not owned by the account.
  • 409 — subscription is already archived; archived subscriptions cannot be updated.
  • 422 — unsupported event type or unknown wildcard namespace, or events array was empty when the events key was sent.
Required scope: webhooks:write.