Webhook Triggers

webhooks are a type of event stream that enables products, vendors, or services to push real time communication in turbine they process and enrich data to send from third party services and platforms to turbine records click save or save and close after making changes view existing webhooks to view existing webhooks navigate to orchestration click webhooks from here you can toggle the enabled button to enable or disable the webhook, or click the desired webhook to view settings and log information create webhook triggers to create a webhook trigger, create a new playbook, upload a playbook, or search for an existing playbook on the playbook, click add a trigger click catch webhook on trigger, enter a webhook title and click generate url or the webhook will not be created once the generate url button has been clicked, the webhook's url is generated in the webhook url field and the copy url link is enabled next, you can edit the webhook settings edit webhook settings to change webhook settings on trigger, click edit webhook on the settings tab, you can update the webhook title, add properties to authenticate the webhook requests, copy the url, and enable/disable the webhook on the logs tab, you can view the webhook logs, view by date, and enable/disable the webhook click save and close to save updates if you do not need to edit your webhook, you can go straight to configuring configure webhooks review / /playbook inputs/create and edit playbook inputs md before configuring webhooks for best practices you're ready to start the configuration process for your webhook click configure to get started the webhook configuration window has three tabs webhook events, outputs, and map to playbook inputs webhook events tab this tab shows the event type with a drop down arrow, which shows you the webhook details, the result, and discovered outputs navigate to / / / /playbooks/actions/discovered outputs and testing md for details on how to view and/or add discovered outputs, the agent/host for that webhook, the time the webhook was last received, and the numbered of triggered playbooks related to that webhook outputs tab this tab shows you all the outputs from the webhook these are default property types if you added any discovered outputs, then they show up with the delete hyperlink any property types without that delete hyperlink are part of the original returned inputs from the webhook map to playbook inputs tab remember the important note on reviewing / /playbook inputs/create and edit playbook inputs md for best practices? that is because on this tab, if you do not see any inputs, it's because your playbook currently does not have any inputs you can add them, and they will display on this tab and just like the action inputs, you can click add a property to see the drop down menu you can add a playbook property or expression selecting playbook property opens the property drawer where you can select the desired property to map filter tab the filter tab allows you to apply a condition on event triggers allowing you to prevent the playbook execution unless the criteria is met you can select a condition type from the drop down next to matches $event data properties here is the list of top level properties that are defined on the $event data object url (object) the url components of the request href (string) the full url of the request protocol (string) the protocol used for the request hostname (string) the hostname of the request port (integer) the port of the request pathname (string) the pathname of the request query (object) the query parameters of the request as key/value pairs hash (string) the hash of the request headers (object) the headers of the request as key/value pairs body (null|array|boolean|number|object|string) the json body of the request authenticate webhooks to configure webhook authentication settings on trigger , click edit webhook on the settings tab, click add a property , then click authentication the authorization property displays with a sub property option basic authentication select basic authentication basic authentication specifies the credentials to be sent in and verified from the authorization header using the basic authentication scheme complete the username and password fields, and click save mirror the username and password with your third party system to remove basic authentication, click the vertical ellipsis, then click remove shared secret authentication select shared secret authentication shared secret authentication specifies the credentials to be sent in and verified from one of the following locations in the webhook requests header, body, or query parameter complete the secret , secret format , and secret location fields to complete the secret location , click add a property from the drop down menu, select one of the following properties request body – extract the secret (password) from the request body request header – extract the secret (password) from the request header request query parameter – extract the secret (password) from a query parameter to remove these properties, click the vertical ellipsis, then click remove view webhook logs on trigger , click edit webhook and then click the logs tab you can view the logs enable or disable the webhook filter by date using jump to date