Panel | |
---|---|
|
...
If you have a custom integration, you can register your webhook to launch an appropriately configured Universal Task.
To allow for the enforcement of read permission for Universal Events, the registration needs to have a security context. Registrations will support an enable and disable mechanism, as well as an ability to assign an Execution User.
If no Execution User is explicitly assigned, the registration will run under the security context of the user who enabled the registration.
In order for a registration to trigger, the Execution User must have the following authorization.
Read permission for the published Universal Event.
If a Task is specified instead of a URL, Launch permission for the Task.
If a Task is specified instead of a URL, any permissions required by the Task Instance, such as Execute permission for Credentials.
Creating a Webhook
Step 1 | From the Services navigation pane, select Administration > Webhooks. The Webhooks list displays: |
---|---|
Step 2 | Enter / select Details for a new Webhook, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a button. The Webhook record is added to the database, and all buttons in the Webhook Details are enabled. |
Note | ||
---|---|---|
| ||
To open an existing record on the list, either:
|
Webhook Details
The following Webhook Details is for a new Webhook. See the field descriptions, below, for a description of all fields that display in the Webhook Details.
Webhook Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the Webhook Details.
Field Name | Description | ||||||
---|---|---|---|---|---|---|---|
General | This section contains general information about the Webhook. | ||||||
Name | User-defined name of this webhook. | ||||||
Description | Description of this record. (Maximum = 255 characters.) | ||||||
Member of Business Services |
| ||||||
Details | This section contains detailed information about the Webhook. | ||||||
Event | |||||||
Action | |||||||
HTTP Authentication | If Action is URL; Specifies the HTTP authentication scheme to use. | ||||||
URL | If Action is URL; Specifies the URL. | ||||||
URL Query Parameters | If Action is URL; Specifies any query parameters to be encoded as a query string and appended to the URL. | ||||||
HTTP Headers | If Action is URL; Specifies the HTTP headers. | ||||||
Task | If Action is Launch Task; Select the task to execute. Click the details icon to view the task definition. | ||||||
Event Criteria | |||||||
Metadata | This section contains Metadata information about this record. | ||||||
UUID | Universally Unique Identifier of this record. | ||||||
Updated By | Name of the user that last updated this record. | ||||||
Updated | Date and time that this record was last updated. | ||||||
Created By | Name of the user that created this record. | ||||||
Buttons | This section identifies the buttons displayed above and below the Webhook Details that let you perform various actions. | ||||||
Save | Saves a new Webhook record in the Controller database. | ||||||
Save & New | Saves a new record in the Controller database and redisplays empty Details so that you can create another new record. | ||||||
New | Displays empty (except for default values) Details for creating a new record. | ||||||
Update | Saves updates to the record. | ||||||
Delete | Deletes the current record. | ||||||
Enable | Enables the current Webhook. | ||||||
Disable | Disables the current Webhook. | ||||||
Refresh | Refreshes any dynamic data displayed in the Details. | ||||||
Close | For pop-up view only; closes the pop-up view of this task. |