{
  "webhooks": {
    "description": "Illustrative webhook event types for shipment notifications.",
    "events": [
      { "type": "shipment.created", "description": "Shipment record created" },
      { "type": "shipment.milestone.updated", "description": "Milestone status changed" },
      { "type": "shipment.exception.raised", "description": "Exception created and requires attention" },
      { "type": "shipment.delivered", "description": "Shipment delivered" }
    ]
  },
  "subscriptionExample": {
    "url": "https://client.example/webhooks/hallmark",
    "events": ["shipment.milestone.updated", "shipment.exception.raised"],
    "secret": "REDACTED"
  }
}