SignalEDI documentation

Webhook Setup

Configure a webhook URL in Settings → Webhooks to receive document lifecycle updates (validation, routing, partner acknowledgements, and errors) without polling.

SignalEDI sends a POST request to your URL with the following JSON payload:

{
  "event": "document.validated",
  "timestamp": "1710000000",
  "data": {
    "documentId": "doc_01HXYZ",
    "partnerId": "partner_abc",
    "documentTypeCode": "850",
    "status": "validated"
  }
}

Webhook events include document.validated, document.routed, document.partner_ack, and document.error. Deliveries also include X-SignalEDI-Timestamp, X-SignalEDI-Event, and X-SignalEDI-Delivery-ID headers.

Verify webhook authenticity by checking the X-SignalEDI-Signature header (HMAC-SHA256 over timestamp + "." + rawBody using your webhook signing secret; reject deliveries whose timestamp skew exceeds ~5 minutes).