Editing a Webhook

Note: only users with the Integration Administrator user role can manage webhooks.

You can edit a webhook in the Webhooks section of HotDocs Advance, accessed through the Configuration pane.

Prerequisites

  • An application endpoint to which you want to send event data
  • A token used to authenticate the request sent from Advance to your application endpoint

To edit a web hook

  1. In the Administration pane, click Manage Web HooksManage webhooks
  2. From the list of web hooks, select the webhook you wish to edit.
  3. In the Detail pane, click ResumeEdit.
  4. You can edit the following web hook details:
    • Name (required) – the webhook's name
    • URL (required) – the URL for the endpoint to which you want Advance to send event data
    • Token (required) – an access token, provided by your application; this is sent in the Authorization header of the request sent to your application endpoint from Advance. You should always authenticate requests from Advance in your own application, using this token.
    • Event type (required) – select an event for the webhook from the following options:
      • NewWorkItemVersionComplete – sends event data when a user completes a new work item version
      • CustomInterviewEvent - sends event data when a template component is triggered in interview
    • Interview Event Name (required when CustomInterviewEvent is selected) - the name of the linked variable used in the template.
    • Active Status – either Active or Inactive; inactive webhooks do not send event data to your endpoint
    • Untrusted SSL certificates – either Block untrusted SSL (default) or Accept untrusted SSL; accepting untrusted SSL allows the webhook to send data over HTTPS even when the SSL certificate is untrusted.
  5. Click Save changes.

Advance saves your changes to the webhook.