Skip to main content
The webhook command group manages outbound webhooks. When an InfraAudit event occurs — such as a drift finding or a new alert — InfraAudit sends an HTTP POST to each registered webhook URL. Use these commands to register, test, and remove webhooks.

webhook list

List all registered webhooks:
Example output:

webhook create

Register a new webhook endpoint. Synopsis:
Example:
To see available event types, run infraudit webhook events.

webhook get

Show details for a specific webhook, including its URL, subscribed events, and delivery statistics: Synopsis:
Example:

webhook delete

Remove a registered webhook: Synopsis:
Example:

webhook test

Send a test payload to a webhook endpoint to verify it is reachable and processing events correctly: Synopsis:
Example:

webhook events

List all available event types that you can subscribe to:
Example event types:
Webhook payloads include an HMAC signature in the X-InfraAudit-Signature header when you provide a --secret. Verify this signature in your endpoint to reject forged requests.