Webhooks
Guardhouse webhooks send outbound POST requests to your application when selected Guardhouse events occur.
Webhooks are not System API endpoints. Your application exposes the receiving endpoint, Guardhouse calls it, and you validate the request signature before processing the event.
Webhook Flow
- Create a webhook subscription in Guardhouse.
- Store the generated webhook secret securely.
- Expose an HTTPS endpoint in your application.
- Validate the
X-Hub-Signatureheader on every delivery. - Process the event body.
- Return a
2xxresponse when processing succeeds.