Skip to content

WebhookSubscription

← All HTTP schemas

An external system’s event subscription.

Shape: object

Property Required Type Description Rules
id yes string (uuid) The subscription identifier.
tenantId yes string The tenant the subscription belongs to.
name yes string The name, unique within the tenant.
url yes string The address events are sent to.
events yes array of string The subscribed event names. See WebhookEvents.
secretConfigurationKey no string The name of the configuration key the signing secret is read from. Not the secret itself.
headers no object Extra headers added to every request.
enabled no boolean Whether the subscription is enabled.
consecutiveFailures no integer (int32) The consecutive-failure count. Once the threshold is exceeded, the subscription disables itself and is written to the audit trail. pattern `^-?(?:0\
createdAt yes string (date-time) The creation time (UTC).
updatedAt yes string (date-time) The last-updated time (UTC).