Webhook

The AD-DA.ca Webhook plugin embeds a lightweight HTTP server directly inside a Q-SYS Core and exposes user-defined webhook endpoints. When an external system sends an HTTP request to a configured Path, the plugin flashes an LED, captures the request payload (JSON body and/or query string), and surfaces matching key/value pairs as Q-SYS controls so that other plugins, scripts, or design logic can react to the incoming data.

The plugin is built on a custom Express-like HTTP server module with middleware support, route parameters, JSON body parsing, Bearer-token authentication, and Host-header interface filtering. Parameters from the query string and the JSON body are merged automatically (body values take precedence on collision), allowing the same endpoint to be triggered from either GET or POST requests.

In addition to user-defined webhooks, the plugin exposes a set of built-in endpoints to read the design status and inventory, and to remotely drive Q-SYS Named Components and Named Controls. This makes the plugin a single entry point for integrating Q-SYS with external automation systems, control panels, mobile apps, and cloud services.

Release note

[2026-06] : V1.2.0.0

• Migrated to Express-like HTTP server module with middleware support

• Added built-in /status and /inventory endpoints returning Design.GetStatus() and Design.GetInventory() as JSON

• Added Body and Code Response Controls

• Added Path sanitization and case-insensitive route matching

• New UI
  
  Fixes

• Memory leak fixed under heavy load
  

[2025-07] : V1.1.0.0

• Added Data Pair Count property

• Added Complete URL Path controls

• Initial release to Asset Manager
  

[2025-04] : V1.0.0.0

• Initial release