Webhooks

A webhook is a standard for sending messages from an app when an event occurs. AgilePoint NX uses webhooks to send notifications based on events that occur within an NX app or in AgilePoint Server.

Figure: Webhooks Home screen

Webhooks Home screen

Video: Manage Your Organization

Examples

Prerequisites

How to Start

  1. Click Manage.

    Click Manage
  2. In the Manage Center, clickSystem > Webhooks.

    Click Webhooks

Fields

Field NameDefinition

Create a Webhook
Opens this Screen:
Add Webhook screen
Function of this Screen:
Creates a webhook to send a notification when an event occurs.

Manage Secret Key
Opens this Screen:
Manage Secret Key screen
Function of this Screen:
Configures secret keys to authenticate webhook notifications.

Manage Common Headers
Opens this Screen:
Manage Common Headers screen
Function of this Screen:
Configures the custom headers to add in all webhook notifications as a name/value pair.

Name
Function:
Shows the name of the webhooks you created.
Accepted Values:
Read only.

Notification URL
Function:
Shows the endpoint service URL where you get a webhook notification when an event occurs.
Accepted Values:
Read only.

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

Actions
Function:
Specifies whether to change the webhook information you created.
Accepted Values:
  • Edit Webhook Edit Webhook icon - Lets you change the webhook information.
  • Delete Webhook Delete Webhook icon - Deletes the webhook.
Default Value:
None

Search Search icon
Function:
Does a search of your webhooks based on the information you specify.