Add Webhook screen

Creates a webhook to send a notification when an event occurs.

Figure: Add Webhook screen

Add Webhook screen

Video: Manage Your Organization

Examples

Prerequisites

Good to Know

  • To receive webhook notifications, the app or service at the notification endpoint URL must be able to process HTTP POST requests.
  • Webhooks can be associated with events that occur at runtime, or they can be associated with events that are related to security — for example, groups, roles, and delegations. These two types of events can not be combined in the same webhook.
  • When you associate a webhook with an app, process model, orprocess instance, the webhook is limited to the context of the specified app, process model, or process instance. This choice is for organizational purposes. Because the events for which a webhook listens are runtime events, all the events actually occur in process instances (or application instances if they are form-based apps). In other words, if you associate a webhook with a process model, webhook notifications are send for all process instances associated with that process model. If you associate a webhook with an app, webhook notifications are sent for the process instances associated with all process models within the app.

How to Start

  1. Click Manage.

    Click Manage
  2. In Manage Center, click System > Webhooks.

    Click Webhooks
  3. On the Webhooks screen, click Create a Webhook.

    Click Create A Webhook

Fields

Field NameDefinition

Name
Description:
Specifies the name of a webhook to create.
Allowed Values:
One line of text (a string).

Accepted:

  • Letters
  • Numbers
  • Spaces
Default Value:
None
Example:
Refer to:

Webhook Notification URL
Description:
Specifies the endpoint service URL where you get a webhook notification when an event occurs.

To receive webhook notifications, the app or service at the notification endpoint URL must be able to process HTTP POST requests.

Allowed Values:
An endpoint service URL that is compatible with webhooks.
Default Value:
None
Example:
https://mydomain.com/a8jjfsla1-9371-4ed6-a43e-91a7a32a07cd

Description
Description:
A description of the webhook.
Allowed Values:
More than one line of text.
Default Value:
None
Example:
Refer to:

Status
Description:
Specifies whether to activate the webhook to send a notification when an event occurs.
Allowed Values:
  • On - The webhook is active and sends notifications.
  • Off - The webhook is not active and does not send notifications.
Default Value:
On

Type of Event
Description:
Specifies whether to use runtime events to send notifications.
Allowed Values:
  • Workflow/Instance Based - Sends webhook notifications when the specified runtime events occur.
  • Access Control Based - Sends webhook notifications when the specified security-related events occur.
Default Value:
Workflow/Instance Based

Process Instance Started
Description:
Specifies whether the webhook sends a notification when a process instance starts.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Process Instance Suspended
Description:
Specifies whether the webhook sends a notification when a process instance is Suspended.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Process Instance Resumed
Description:
Specifies whether the webhook sends a notification when a process instance is resumed.

Only suspended process instances can be resumed. If a parent process instance is resumed, any suspended child process instances are resumed as well.

To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Process Instance Completed
Description:
Specifies whether the webhook sends a notification when a process instance is Completed.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Process Instance Cancelled
Description:
Specifies whether the webhook sends a notification when a process instance is Cancelled.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Process Instance Deleted
Description:
Specifies whether the webhook sends a notification when a process instance is deleted.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Assigned
Description:
Specifies whether the webhook sends a notification when a task is Assigned.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Reassigned
Description:
Specifies whether the webhook sends a notification when a task is Assigned to new participant.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Overdue
Description:
Specifies whether the webhook sends a notification when a task is Overdue.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Completed
Description:
Specifies whether the webhook sends a notification when a task is Completed.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Cancelled
Description:
Specifies whether the webhook sends a notification when a task is Cancelled.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Delegated To Other User
Description:
Specifies whether the webhook sends a notification when a task is delegation.

A temporary reassignment of a human task to a different user. Delegations can be used, for example, to temporarily reassign a task when a user is out of the office.

To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Task Released To Pool
Description:
Specifies whether the webhook sends a notification when a task when a runtime app user releases the assigned task to the pool.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Power Automate Trigger
Description:
Specifies whether the webhook sends a notification when the Trigger Flow activity starts a Microsoft Power Automate flow.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Email Notification Sent
Description:
Specifies whether the webhook sends a notification when an email notification was sent.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Email Notification Failed
Description:
Specifies whether the webhook sends a notification when an email notification is not delivered.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

User Added
Description:
Specifies whether the webhook sends a notification when a user is created in AgilePoint NX.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

User Removed
Description:
Specifies whether the webhook sends a notification when a user is deleted from the AgilePoint system.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

User Updated
Description:
Specifies whether the webhook sends a notification when a user's basic information, such as name and e-mail address is changed.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Group Added
Description:
Specifies whether the webhook sends a notification when a group is created in AgilePoint NX.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Group Removed
Description:
Specifies whether the webhook sends a notification when a group is deleted from the AgilePoint system.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Group Updated
Description:
Specifies whether the webhook sends a notification when a basic information of a group is changed.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Group Member Added
Description:
Specifies whether the webhook sends a notification when a user is added to a group.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Group Member Removed
Description:
Specifies whether the webhook sends a notification when a user is deleted from a group.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Role Added
Description:
Specifies whether the webhook sends a notification when a role is created in AgilePoint NX.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Role Removed
Description:
Specifies whether the webhook sends a notification when a role is deleted in AgilePoint NX.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Role Updated
Description:
Specifies whether the webhook sends a notification when a basic information of a role is changed.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Role Member Added
Description:
Specifies whether the webhook sends a notification when a member is added to a role.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Role Member Removed
Description:
Specifies whether the webhook sends a notification when a member is deleted from a role.
To Open this Field:
  1. On the Type of Event filed, select Access Control Based.
Allowed Values:
  • Selected - The webhook listens for this type of event and sends a notification when the event occurs.
  • Deselected - The webhook does not listen for this type of event or send a notification when the event occurs.
Default Value:
Deselected

Select which Application(s), Process Model(s) or Process Instance(s) triggers your Workflow Events
Description:
Specifies what causes your webhook to start send a notification.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
Allowed Values:
  • Application - The webhook sends a notification when a runtime event occurs on the specified application.
  • Process Model - The webhook sends a notification when a runtime event occurs on the specified process model.
  • Process Instance - The webhook sends a notification when a runtime event occurs on the specified process instance.

One webhook can use only one of these categories.

Default Value:
Application

App
Description:
Specifies the name of an app that causes your webhook to send a notification.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
  2. On the Select which Application(s), Process Model(s) or Process Instance(s) triggers your Workflow Events field, select Application.
Allowed Values:
One or more AgilePoint NX apps from the list.

You can use the Auto Suggest or Wild Card method to search.

Default Value:
None
Example:
Refer to:

Process Model
Description:
Specifies the name of the process model that causes your webhook to send a notification.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
  2. On the Select which Application(s), Process Model(s) or Process Instance(s) triggers your Workflow Events field, select Process Model.
Allowed Values:
One or more process model names from the list.

You can use the Auto Suggest or Wild Card method to search..

Default Value:
None

Process Instance
Description:
Specifies the name of the process instance that causes your webhook to send a notification.
To Open this Field:
  1. On the Type of Event field, select Workflow/Instance Based.
  2. On the Select which Application(s), Process Model(s) or Process Instance(s) triggers your Workflow Events field, select Process Instance.
Allowed Values:
One or more process instance names separated by commas (,).
Default Value:
None

Auto Suggest / Wild Card
Description:
Specifies in which method to search the app or process model.
To Open this Field:
  1. On the Select which Application(s), Process Model(s) or Process Instance(s) triggers your Workflow Events field, select App or Process Model.
Allowed Values:
  • Auto Suggest - Selects one or more apps or process models.

    Enter the first three characters of the app or process model name for suggested matches.

  • Wild Card - Specifies all apps or process models whose names have common text patterns. This method matches the characters you specified and words in apps or process models.

    Enter wild card strings separated by commas (,).

    Use '?' for one character and '*' for more than one character. In this format: app, ap*, ?app, app?

Default Value:
Auto Suggest
Example:
The example is shown for Customer Enquiry app:
  • Auto Suggest - cus
  • Wild Card - customer ?nquiry (one wild card character), cust* (more than one character).

Active Always / Active For A Period Of Time
Description:
Specifies whether to set the time period for your webhook to deactivate.
To Open this Field:
  1. Click Advanced.
Allowed Values:
  • Active Always - The webhook is active and sends notifications as long as the Status is On.
  • Active For A Period Of Time - Lets you set the time period that your webhook is active.
Default Value:
Active Always

From
Description:
Specifies the start date the webhook is activated to send notifications.
To Open this Field:
  1. Click Advanced.
  2. Select Active For A Period Of Time.
Allowed Values:
  • A date from the date picker.
  • A valid date in this format [yyyy/mm/dd].
Default Value:
None

To
Description:
Specifies the end date the webhook is deactivated and does not send notifications.
To Open this Field:
  1. Click Advanced.
  2. Select Active For A Period Of Time.
Allowed Values:
  • A date from the date picker.
  • A valid date in this format [yyyy/mm/dd].
Default Value:
None

Headers
Description:
Specifies the custom headers to add to the webhook you configure.

Headers are usually used to give security information, such as authentication credentials.

To Open this Field:
  1. Click Advanced.
Allowed Values:
  • Name - Specifies the name of the header in name/value pair.
  • Value - specifies the value for the header in name/value pair.

Use the Add Fields Add Fields icon button to add Name and Value field pairs for the webhook.

Default Value:
None

Add Fields Add Fields icon
Function:
Adds a row for the Name and Value fields.

Delete Delete icon
Function:
Deletes the row with Name and Value fields.