HomeGuidesAPI Reference
GuidesAPI ReferenceGitHubAirheads Developer CommunityLog In

Getting Started with Webhooks

Webhooks are HTTP callbacks

Webhooks are automated messages sent as an HTTP request (typically a POST) used to deliver real-time information across applications. Typically a user will have a URL generated from a client-side application that they then provide to the server-side application as a destination for the automated messages. The possibilities for Webhooks are endless and are extremely useful when developing event-driven automations.

Webhooks are primarily used for server-to-server or app-to-app communication. You can create an application for Central to either:

  • Poll data using REST API
  • Use Streaming API to subscribe to topics to receive a constant stream of information for the chosen topic
  • Configure/Add Alerts and use Webhooks as a destination to send Alert notifications to a web-server, whenever an alert is triggered

Webhooks Configuration

Central provides Webhooks as HTTP callbacks that are usually triggered when an event occurs. You can configure Webhooks either through the Aruba Central's Web UI by going to the Account Home and selecting Webhooks or by using REST API. Once the Webhook is configured, when configuring Alerts you can select Webhook under Notification Options and select the Webhook you've configured. Once an alert is configured and a Webhook is added for that alert as the notification method, you would receive a notification whenever an alert is triggered. See Using Alerts with Webhooks for more details. For more information on the various alerts available, its description and JSON payload, check out the following:

In Aruba Central, you can create up to 10 configured Webhooks. For each configured Webhook, you can have up to 3 URLs as endpoints for the data to be sent to when an alert is generated to increase redundancy. For more information about Webhooks and ways to configure/create a Webhook, refer to the Webhooks page on Central's Documentation Center.
As for Alerts, you can configure/add as many alerts as you need from the different type of alerts available on Central. For more information refer to the Configuring Alerts page on Central's Documentation Center.


TLS Support

  • TLS v1.3 is supported for secure communication between Central and your web-server
  • HMAC is used for verifying the authenticity and data integrity of the Alerts notification sent by Central over Webhook

To start using Webhooks and to integrate it with your application, you need to know about the Webhook's authentication mechanism.