Edit Webhook screen

Changes a webhook.

Figure: Edit Webhook screen

Edit 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, select a webhook.

    Click Edit Webhook
  4. Click Edit Webhook.

    Click Edit Webhook

Fields

Field NameDefinition

Name

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

Accepted:

  • Letters
  • Numbers
  • Spaces
Default Value:
None

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 only in one 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 button to add the Name and Value fields 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.