Webhooks

Guide to using webhooks for integrations with Lager Guru.

Overview

Webhooks allow external systems to receive real-time notifications about events in Lager Guru.

Supported Events

Inventory Events

• inventory.item.created
• inventory.item.updated
• inventory.movement.created
• inventory.low_stock

Shipment Events

• shipment.created
• shipment.updated
• shipment.status_changed
• shipment.completed

Pick & Pack Events

• pick_list.created
• pick_list.completed
• pack_session.created

Webhook Configuration

Creating Webhook

1. Navigate to System Settings → Integrations → Webhooks
2. Click Create Webhook
3. Configure:
   • Webhook URL
   • Events to subscribe to
   • Secret for signature verification
4. Save webhook

Webhook Payload

{
  "event": "shipment.created",
  "timestamp": "2025-12-02T10:00:00Z",
  "data": {
    "id": "uuid",
    "status": "pending",
    "tenant_id": "uuid"
  }
}

Security

Signature Verification

Webhooks include a signature header for verification:

X-Lager-Guru-Signature: sha256=...

Verify signature using your webhook secret.

Testing

Local Testing

Use tools like ngrok to test webhooks locally:

ngrok http 3000

Configure webhook URL to ngrok URL.

Best Practices

• Use HTTPS for webhook URLs
• Verify webhook signatures
• Implement idempotency
• Handle retries gracefully
• Log webhook events

Next Steps

• API Reference
• Integrations
• Developer Guide