Webhooks

Webhooks allow Scrollengine to notify your external systems in real-time when events occur. Use webhooks to build custom integrations, automate workflows, or sync data with other tools.

What are webhooks

A webhook is an HTTP POST request sent to a URL you specify whenever a specific event happens in Scrollengine. Your server receives the event data and can act on it.

Available webhook events

Event	Trigger
order.created	New delivery order is placed
order.updated	Order details or status change
order.delivered	Order is marked as delivered
order.cancelled	Order is cancelled
route.created	New route is created
route.started	Driver starts a route
route.completed	All stops on a route are done
driver.assigned	Driver is assigned to an order or route

Setting up a webhook

1. Go to Settings > Integrations > Webhooks
2. Click Add Webhook
3. Enter:
   • URL — The endpoint on your server that will receive the webhook
   • Events — Select which events to subscribe to
   • Secret — A shared secret for verifying webhook authenticity
4. Click Save

Webhook payload

Webhooks are sent as HTTP POST requests with a JSON body:

{
  "event": "order.delivered",
  "timestamp": "2026-03-13T14:30:00Z",
  "data": {
    "order_id": "12345",
    "shopify_order_id": "98765",
    "delivery_method": "local_delivery",
    "status": "delivered",
    "driver": {
      "id": "d-001",
      "name": "John Driver"
    }
  }
}

Verifying webhooks

Each webhook includes a signature header for verification:

1. Scrollengine signs the payload using your shared secret
2. The signature is included in the X-Scrollengine-Signature header
3. Your server should verify the signature before processing

Retry policy

If your endpoint returns a non-2xx status code:

• Scrollengine retries up to 3 times
• Retries use exponential backoff (1 min, 5 min, 30 min)
• After 3 failures, the webhook is marked as failing
• You'll receive a notification to fix your endpoint

Use cases

• Sync to an ERP — Push delivery data to your inventory or accounting system
• Custom notifications — Trigger SMS, Slack, or other alerts
• Analytics — Feed delivery events into your analytics platform
• Third-party logistics — Notify external carriers or partners