Skip to content
API Reference
/
/
Peppol Document Received

Peppol Document Received
Webhook

Request

Sent when an incoming Peppol document is received.

Headers
X-Connect-Signaturestringrequired

HMAC SHA-256 signature of the webhook request. It is calculated with the webhook secret over the value ${X-Connect-Timestamp}.${rawRequestBody}.

X-Connect-Timestampinteger, (int64)required

Unix timestamp, in seconds, used when calculating the webhook signature.

X-Connect-Event-Idstringrequired

Unique identifier of the webhook event. This is the same value as data.eventId in the payload.

Bodyapplication/jsonrequired
eventTypestringrequired
Value:"peppol.document.received"
timestampstring, (date-time)required
Example:"2025-04-01T10:11:34.518Z"
versionstringrequired
Example:"1"
dataobject(PeppolDocumentReceivedWebhookEventDataDto)required
Payload
{
  "eventType": "peppol.document.received",
  "timestamp": "2025-04-01T10:11:34.518Z",
  "version": "1",
  "data": {
    "eventId": "01KN4017Y7T44D4V0EY21RHFZX",
    "companyId": "01KN4017Y7T44D4V0EY21RHFZX",
    "documentType": "BIS_BILLING_INVOICE_V3",
    "senderId": "01KN4017Y7T44D4V0EY21RHFZX",
    "id": "2006-01/invoice-012345",
    "eventType": "INCOMING_PEPPOL_DOCUMENT"
  }
}

Responses

Return a 2xx response to acknowledge successful receipt.