Ionluz Com Br Webhooks

generated: '2026-11-12'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://app.ionluz.com.br/docs/api/webhooks
sources:
- https://app.ionluz.com.br/docs/api/webhooks
description: IonLuz outbound webhooks. Register a URL and secret in the dashboard to receive events about leads and proposals.
events:
- event: lead.criado
  description: Dispatched when a lead (quotation) is created in the account, either via the public capture page, POST /v1/quote, or the MCP with
    persistence.
- event: proposta.aberta
  description: Dispatched once per proposal when the end‑customer opens the proposal for the first time.
- event: proposta.aceita
  description: Dispatched once per proposal when the end‑customer accepts the proposal within its validity period.
- event: ping
  description: Sent when you click “Testar” in the dashboard, used to validate your signature verification before receiving real events.
delivery:
  signature: Header X-Ionluz-Signature in the format t=<unix>,v1=<hmac‑sha256‑hex>. The HMAC is calculated with the webhook secret over the string
    "<t>.<raw‑body>".
  content_type: application/json
note: Only HTTPS public hosts are accepted; redirects are not followed. The X‑Ionluz‑Delivery header contains a unique delivery ID for deduplication
  and secret rotation applies to the next delivery after a change.
docs: https://app.ionluz.com.br/docs/api/webhooks