Infranest Webhooks

generated: '2026-11-03'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://developers.infranest.io/webhooks.md
sources:
- https://developers.infranest.io/webhooks.md
- https://developers.infranest.io/reference/alerts.md
- https://developers.infranest.io/reference/alerts
description: InfraNest webhooks deliver JSON POSTs with an event name, timestamp and data payload.
events:
- event: domain.expiring
  description: A domain is approaching its expiration date.
- event: domain.status_changed
  description: A domain's status has changed, such as nameservers being updated.
- event: domain.dnssec_broken
  description: DNSSEC validation for a domain has failed.
- event: server.status_changed
  description: A server's status has changed, e.g., powered on.
- event: monitor.alert
  description: A monitor check has changed state (up/down) or other alert condition.
- event: dns.records_changed
  description: DNS records in a zone have been modified.
- event: dns.live_mismatch
  description: Live DNS records differ from the expected configuration.
- event: watched_domain.dropping_soon
  description: A watched domain is expected to drop soon.
- event: watched_domain.available
  description: A watched domain has become available for registration.
- event: watched_domain.registered
  description: A watched domain has been registered.
- event: watched_domain.failed
  description: A watched domain registration attempt failed.
- event: watched_domain.in_auction
  description: A watched domain is now in an auction.
- event: watched_domain.released
  description: A watched domain has been released back to the pool.
- event: watched_domain.renewed
  description: A watched domain has been renewed.
- event: watched_domain.funding_short
  description: A watched domain is short on funding and may drop.
- event: certificate.expiring
  description: A TLS certificate is nearing its expiration.
- event: certificate.expired
  description: A TLS certificate has expired.
- event: certificate.changed
  description: A TLS certificate has been changed.
- event: certificate.weak
  description: A TLS certificate is considered weak due to issues.
- event: certificate.unexpected
  description: An unexpected TLS certificate was observed.
delivery:
  signature: HMAC‑SHA256 of "<timestamp>.<body>" using the endpoint's signing secret, sent in header `X-InfraNest-Signature-V2` (prefixed with
    `sha256=`).
  retries: 'Up to 6 attempts: first retry after 30 seconds, then 5 minutes, 30 minutes, 2 hours, and 8 hours. A delivery is considered successful
    only with a 2xx HTTP response within 10 seconds.'
docs: https://developers.infranest.io/webhooks.md