Create a Webhook Action

Use the webhook action to call a third-party web service. For example, use this action to update a database that is not accessible from the Vantagepoint application server. You can create these actions for user initiated workflows or scheduled workflows.

To create a webhook action:

  1. In the Navigation pane, select Settings > Workflow > User Initiated Workflows or select Settings > Workflow > Scheduled Workflows.
  2. On the User Initiated Workflows form or Scheduled Workflows form, use the drop-down list in the header field to select the hub or other area, such as employees or billing terms.
  3. In the Workflows grid (or Scheduled Workflows grid), select the workflow row (event) to which you want to add the action.
  4. In the Actions grid, click Add Action > Webhook.
  5. In the Webhook URL field on the Webhook dialog box, enter the location of the webhook.
    After you enter the URL, you can specify the Username and Password, or Secret and Public Key, or both sets of credentials, or no credentials for the webhook.
  6. Use the Authorization fields to specify the username and password for the webhook action.
    Note that if you specify a Username or Password, both values must be completed. The Password field is encrypted for added security.
  7. Use the Security fields to record the secret or public key information that is required for the webhook connection.
    Note that if you specify a Secret or a Public Key, both values must be completed. The Secret field is encrypted for added security.
  8. In the Configuration fields, set limits on the number of retries allowed and specify how many seconds will elapse before the process times out.
    OptionDescription
    Retries Set the number of retries allowed. The default value is 0 and the minimum value allowed should be 0. The maximum value allowed is 10.
    Timeout Set the number of seconds that will elapse before the process times out. The default value is 5 seconds and the minimum value allowed is 1 second. The maximum value allowed is 60 seconds.
  9. In the Arguments grid, specify name-value pairs for each argument:
    1. In Name, enter a descriptive name for the argument.
    2. In Expression, click to display the Expression Builder Dialog Box and then specify the SQL expression that will be used to determine the value of the argument at run time.
    3. Click +Add Argument to add the argument to the Arguments grid.
  10. To have the action run after you save the entire record, including all grid data, select the Invoke after changes are saved option.
  11. Click Save.
    The action that you created is now listed in the Actions grid of the User Initiated Workflows form or the Scheduled Workflows form.