Webhook Events
Every webhook payload includes these common fields:
{ "event": "invoice.delivered", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", ...event-specific fields}Invoice Events
Section titled “Invoice Events”invoice.created
Section titled “invoice.created”Fired when a new invoice is created.
{ "event": "invoice.created", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "direction": "outgoing", "amount": 150000, "currency": "EUR", "state": "Draft"}invoice.sent
Section titled “invoice.sent”Fired when an invoice is successfully transmitted to the Peppol network.
{ "event": "invoice.sent", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "state": "Sent", "message_id": "msg-a1b2c3d4"}invoice.delivered
Section titled “invoice.delivered”Fired when delivery to the recipient is confirmed.
{ "event": "invoice.delivered", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "state": "Delivered", "delivered_at": "2026-03-27T10:30:00+00:00"}invoice.failed
Section titled “invoice.failed”Fired when invoice delivery fails.
{ "event": "invoice.failed", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "state": "Failed", "error": "Recipient not registered on Peppol network", "error_code": "RECIPIENT_NOT_FOUND"}invoice.status_changed
Section titled “invoice.status_changed”Fired whenever the invoice state changes (covers all transitions).
{ "event": "invoice.status_changed", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "previous_state": "Sending", "new_state": "Sent"}invoice.payment_status_changed
Section titled “invoice.payment_status_changed”Fired when the payment status of an invoice changes.
{ "event": "invoice.payment_status_changed", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "payment_status": "partially_paid", "total_paid_cents": 75000, "amount": 150000}Participant Events
Section titled “Participant Events”participant.created
Section titled “participant.created”{ "event": "participant.created", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "participant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "identifier": "0088:1234567890123", "name": "My Company"}participant.activated
Section titled “participant.activated”{ "event": "participant.activated", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "participant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "identifier": "0088:1234567890123"}participant.deactivated
Section titled “participant.deactivated”{ "event": "participant.deactivated", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "participant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "identifier": "0088:1234567890123", "reason": "User requested deactivation"}Company Events
Section titled “Company Events”company.created / company.updated / company.deleted
Section titled “company.created / company.updated / company.deleted”{ "event": "company.updated", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "company_name": "My Company"}Domain Events
Section titled “Domain Events”domain.verified
Section titled “domain.verified”{ "event": "domain.verified", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "domain": "example.com"}domain.failed
Section titled “domain.failed”{ "event": "domain.failed", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "domain": "example.com", "reason": "DNS verification failed"}Limit Events
Section titled “Limit Events”limit.warning
Section titled “limit.warning”Fired when credit usage reaches 90% of the limit.
{ "event": "limit.warning", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "credit_type": "peppol", "remaining": 10, "limit": 100}limit.reached
Section titled “limit.reached”Fired when credits are fully exhausted.
{ "event": "limit.reached", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "credit_type": "peppol", "remaining": 0, "limit": 100}limit.exceeded
Section titled “limit.exceeded”Fired when usage exceeds the credit limit (overage).
{ "event": "limit.exceeded", "timestamp": "2026-03-27T10:30:00+00:00", "company_id": "550e8400-e29b-41d4-a716-446655440000", "credit_type": "peppol", "overage": 5}