Subscribing and Managing Subscriptions

You can manage subscriptions through the webhook subscription endpoints in the API:

• Create a webhook subscription
  • Create a subscription with a callback_url and an events array.
  • The response returns a secret — see Verify the signature. This secret is shown only once, at creation, and cannot be retrieved later — store it securely.
• List webhook subscriptions
• Get a webhook subscription
  • List / Get subscriptions to inspect their status (enabled, disabled_at, disabled_reason, last_failure_status, consecutive_failures, etc). The secret is never returned again.
• Update a webhook subscription
  • Update a subscription to change its callback URL or events, or to enable/disable it.
• Delete a webhook subscription
  • Delete a subscription to stop deliveries permanently.