Webhook Widget
Menu Parcel delivery

Example

Parcel delivery

An arrival window with a live progress bar.

live progressspanslight & dark
Parcel delivery
json
{
  "v": 1,
  "preferredFamily": "systemMedium",
  "refresh": 900,
  "accessibility": "Running shoes arriving today between 09:05 and 10:05, 8 stops away",
  "url": "https://track.example.com/parcels/7Q4K2",
  "view": {
    "type": "vstack",
    "align": "leading",
    "spacing": 0,
    "padding": 14,
    "children": [
      {
        "type": "hstack",
        "spacing": 6,
        "children": [
          {
            "type": "symbol",
            "name": "shippingbox.fill",
            "style": "subheadline",
            "color": "orange",
            "accentable": true
          },
          {
            "type": "text",
            "text": "Arriving today",
            "style": "subheadline",
            "weight": "semibold",
            "color": "primary"
          },
          {"type": "spacer"},
          {
            "type": "text",
            "text": "OUT FOR DELIVERY",
            "style": "caption2",
            "weight": "bold",
            "color": "orange",
            "padding": {"top": 2, "bottom": 2, "leading": 6, "trailing": 6},
            "bg": "orange/15",
            "corner": 5
          }
        ]
      },
      {"type": "spacer", "minLength": 8},
      {
        "type": "text",
        "style": "headline",
        "lines": 1,
        "spans": [
          {"text": "Running shoes", "color": "primary"},
          {"text": " and 2 more items", "color": "secondary", "weight": "regular"}
        ]
      },
      {
        "type": "text",
        "style": "subheadline",
        "spans": [
          {"text": "Between ", "color": "secondary"},
          {
            "text": "09:05",
            "weight": "semibold",
            "monoDigits": true,
            "color": "primary"
          },
          {"text": " and ", "color": "secondary"},
          {
            "text": "10:05",
            "weight": "semibold",
            "monoDigits": true,
            "color": "primary"
          }
        ]
      },
      {"type": "spacer"},
      {
        "type": "gauge",
        "from": "2026-08-11T07:05:00Z",
        "until": "2026-08-11T10:05:00Z",
        "tint": "orange",
        "accentable": true
      },
      {"type": "spacer", "minLength": 6},
      {
        "type": "hstack",
        "spacing": 5,
        "children": [
          {
            "type": "symbol",
            "name": "truck.box.fill",
            "style": "caption",
            "color": "secondary"
          },
          {
            "type": "text",
            "text": "8 stops away",
            "style": "caption",
            "color": "secondary"
          },
          {"type": "spacer"},
          {
            "type": "text",
            "text": "Order 7Q4K2",
            "style": "caption",
            "color": "tertiary",
            "monoDigits": true
          }
        ]
      }
    ]
  }
}
This payload is for the medium size. The larger sizes show the same payload with empty space around it. For a smaller size, the server sends a different payload.

How it works

The bar is a gauge with from and until: the time the parcel left the depot and the end of its delivery window. The phone moves the bar every second between fetches. The server sends only the start and the end.

"Between 14:05 and 15:05" is one text made of spans. The times are bold with equal-width digits, the words are secondary, and the line wraps as one paragraph.

This payload has no background and no hex colour. The widget uses the system background, and its colours change with light and dark mode. Use the control above.

Put it on your Home Screen

We serve this example at the URL below. The server generates the timestamps at the time of each request. Add the URL as a hook in the app, and the widget works on your phone.

URL
https://webhookwidget.com/demo/delivery

Open the payload →

Next

Family rota: Whose turn it is this week, shared with the household.
All examples