Receive events with webhooks
Subscribe to event, offer and PO changes in real time.
Webhooks push events to your endpoint the moment they happen — no polling. Register an endpoint, verify the signature, and react to changes in your own systems.
Register an endpoint
curl -X POST https://api.teradix.com/v1/webhooks \
-H "Authorization: Bearer $TOKEN" \
-d '{ "url": "https://erp.example.com/tx-hook",
"events": ["offer.submitted", "po.acknowledged"] }'Verify the signature
Every delivery is signed. Verify the X-Teradix-Signature header against your signing secret before trusting the payload.
Always return 2xx fast
Acknowledge the webhook within 5 seconds, then process asynchronously. Slow endpoints are retried with backoff and may be disabled.
| Event | Fires when |
|---|---|
| offer.submitted | A supplier submits or revises an offer |
| event.awarded | A buyer confirms an award |
| po.acknowledged | A supplier accepts a PO |