Skip to content

Webhooks

A webhook sends each Airgate event of the topics you choose as an HTTPS POST with a JSON body to an endpoint you own. Use it to feed a SOAR, open tickets, or trigger automation when a device is rejected, a guest registers or an alert fires. Webhooks are configured on Settings › Webhooks › Webhooks.

Key facts:

  • Topics: exact (auth.reject), prefix (guest.*) or everything (*). Available topics include auth.accept, auth.reject, tacacs.*, session.start / update / stop, endpoint.*, guest.created, guest.login, guest.expired, cert.issued, cert.revoked, coa.sent, config.changed, system.alert, nad.problem and admin.audit.
  • Body: {"id", "topic", "time", "tenant_id", "tenant", "data"}.
  • Headers: X-NAC-Event (topic), X-NAC-Delivery (delivery ID), X-NAC-Timestamp (Unix seconds) and, with a signing secret, X-NAC-Signature: sha256=<hex HMAC-SHA256 of "<timestamp>.<body>">.
  • Success is any 2xx answer. Network errors, 408, 429 and 5xx are retried with exponential backoff (30 s doubling, at most 1 hour), up to Max retries (0 to 10, default 5). Other 4xx answers are final.
  • Send test event delivers the topic webhook.test. Each webhook has a Deliveries list with the request, response and Redeliver.

For the full setup, the topic list and a signature check example, see Webhooks and HTTP actions.

© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security