Watches

Get a signed webhook the moment a road changes light.

Free during early access

How webhooks work

We POST to your URL when a watched road turns green, amber or red.
Every delivery is signed with your secret in the LaneRouter-Signature header.
Failed deliveries retry after 1, 5, 30 and 120 minutes.
A watch pauses after 25 failures in a row. A successful test resumes it.

Payload

POST

{
  "type": "road.changed",
  "test": false,
  "watch_id": 12,
  "road": "shop.example/checkout",
  "action": "checkout",
  "road_id": 128,
  "url": "https://lanerouter.com/road/128",
  "condition": "wall",
  "light": "red",
  "previous_light": "green",
  "changed_at": "2026-11-02T14:05:00.000Z",
  "delivery_id": 341,
  "attempt": 1
}

Verify the signature

Node.js

import { verifySignature } from 'lanerouter'

const ok = await verifySignature(
  rawBody,
  req.headers['lanerouter-signature'],
  process.env.LANEROUTER_WEBHOOK_SECRET
)

Create a watch from code

HTTP

curl -X POST https://lanerouter.com/api/v1/watches \
  -H "Authorization: Bearer lr_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"shop.example/checkout","action":"checkout","url":"https://your-app.example/hooks/lanerouter"}'

Agents can also use the watch_road, unwatch_road and list_watches MCP tools.

Watches

Sign in with your LaneRouter key