Beel Es Webhooks

generated: '2026-10-30'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.beel.es/webhooks.md
sources:
- https://docs.beel.es/webhooks.md
- https://docs.beel.es/webhooks/events.md
- https://docs.beel.es/webhooks/signatures.md
- https://docs.beel.es/webhooks/retries.md
description: BeeL webhooks deliver signed JSON payloads via HTTP POST. Deliveries are secured with an HMAC‑SHA256 signature in the `BeeL-Signature`
  header and require an API key with the `webhooks:read`/`webhooks:write` scopes. Failed deliveries are automatically retried.
events:
- event: account.claimed
  description: Delivered when an account holder you provisioned activates their credentials (sets a password and takes ownership of the account).
- event: company.created
  description: Delivered when an account holder you provisioned registers their first (or an additional) NIF (company) during onboarding.
- event: email_domain.failed
  description: Delivered when a sending domain of your account changes to `FAILED`.
- event: email_domain.removed
  description: Delivered when a sending domain of your account is removed.
- event: email_domain.verified
  description: Delivered when a sending domain of your account changes to `VERIFIED`.
- event: invoice.email.sent
  description: Delivered when an invoice has been successfully sent to its recipients via email.
- event: invoice.issued
  description: Delivered when an invoice is finalized and issued to the customer.
- event: invoice.pdf.generated
  description: Delivered when BeeL stores the PDF of an invoice.
- event: invoice.schedule_failed
  description: Delivered when an invoice you scheduled could not be issued on its date and BeeL gave up retrying.
- event: invoice.voided
  description: Delivered when an invoice is voided.
- event: recurring_invoice.paused
  description: Delivered when a recurring invoice (schedule) stops generating without anyone asking for it.
- event: representation.signed
  description: Delivered when an account holder you provisioned signs the VeriFactu fiscal representation for one of their NIFs.
- event: verifactu.status.updated
  description: Delivered whenever the VeriFactu registration status of an invoice changes.
delivery:
  signature: HMAC‑SHA256
  content_type: application/json
note: Signature verification uses the `BeeL-Signature` header (format `t=...,v1=...`). The secret is provided on subscription creation and can
  be rotated via the secret rotation endpoint. Authentication for webhook management uses an API key with the `webhooks:read` and `webhooks:write`
  scopes; the webhook endpoint itself is not authenticated beyond signature verification.
docs: https://docs.beel.es/webhooks.md