A webhook is a mechanism for conveying to some external system a change that took place in NetBox. For example, you may want to notify a monitoring system whenever the status of a device is updated in NetBox. This can be done by creating a webhook for the device model in NetBox and identifying the webhook receiver. When NetBox detects a change to a device, an HTTP request containing the details of the change and who made it be sent to the specified receiver.
See the webhooks documentation for more information.
A unique human-friendly name.
The type(s) of object in NetBox that will trigger the webhook.
If not selected, the webhook will be inactive.
The events which will trigger the webhook. At least one event type must be selected.
|Creations||A new object has been created|
|Updates||An existing object has been modified|
|Deletions||An object has been deleted|
|Job starts||A job for an object starts|
|Job ends||A job for an object terminates|
The URL to which the webhook HTTP request will be made.
The type of HTTP request to send. Options are:
HTTP Content Type
The content type to indicate in the outgoing HTTP request header. See this list of known types for reference.
Any additional header to include with the outgoing HTTP request. These should be defined in the format
Name: Value, with each header on a separate line. Jinja2 templating is supported for this field.
Jinja2 template for a custom request body, if desired. If not defined, NetBox will populate the request body with a raw dump of the webhook context.
A secret string used to prove authenticity of the request (optional). This will append a
X-Hook-Signature header to the request, consisting of a HMAC (SHA-512) hex digest of the request body using the secret as the key.
A set of prescribed conditions against which the triggering object will be evaluated. If the conditions are defined but not met by the object, the webhook will not be sent. A webhook that does not define any conditions will always trigger.
Controls whether validation of the receiver's SSL certificate is enforced when HTTPS is used.
Disabling this can expose your webhooks to man-in-the-middle attacks.
CA File Path
The file path to a particular certificate authority (CA) file to use when validating the receiver's SSL certificate (if not using the system defaults).
The following context variables are available in to the text and link templates.
||The event type (
||The time at which the event occured|
||The type of object impacted|
||The name of the user associated with the change|
||The unique request ID|
||A complete serialized representation of the object|
||Pre- and post-change snapshots of the object|