Subscriptions
Subscriptions allow you to define the types of events you want to be notified about and where you like notifications sent.
When a subscription has been created, it can be updated, or deleted using its subscription ID.
Each subscription contains the following properties:
subscriptionId
— The unique identifier for the subscription. This ID can be used to edit or delete the subscription.name
— The name of the subscription, specified during creation. The name is unique.url
— The URL that the webhook events are sent to. It is a fully qualified https URL.events
— A list of the types of events subscribed to. Each item in the list is the name of an event type. Wildcards are used to subscribe to sets of event types.enabled
— Notifications are only sent to the URL if the subscription is enabled.secret
— A secret used to sign notifications. The current secret is not returned in API responses except when you create a subscription.
Webhook subscription changes, including creating, editing or deleting a subscription, may take up to 30 seconds to take effect.