Webhook Events

Available events

These are the event type values ALPHA delivers today. The type field in the POST body matches one of the values below exactly (including the dot separator).

packing_instructions.ready

When it is sent: Once an order’s packing instructions are ready to be downloaded.

Envelope (all events)

Every delivery uses the same top-level JSON shape:

• id (string, UUID) — unique id for this delivery. Use as your primary idempotency key; matches the webhook-id header.

• type (string) — event type from Available events above.

• timestamp (string, ISO 8601) — when the event was created.

• data (object) — fields depend on type; see below.

data for packing_instructions.ready

• order_id (string) — ALPHA customer-facing order reference (for example ALPHA-ABC123).

• reference (string) — your internal order reference, as supplied when the order was created.

Tip

Use id as the primary idempotency key. If your business logic needs an order-level guard as well, use data.order_id.

Sample payload

Values are illustrative placeholders.

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "packing_instructions.ready",
  "timestamp": "2026-04-20T08:10:00.000000+00:00",
  "data": {
    "order_id": "ALPHA-ABC123",
    "reference": "778899"
  }
}