Event types#

This page describes the JSON body ALPHA sends to your webhook endpoint. Verify the signature first (Verify signatures), then branch on type.

Example payload#

Complete delivery body for packing_instructions.ready:

                                            {
  "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"
  }
}

                                        

Tip

Use id as your primary idempotency key. To download packing instructions, pass data.reference or data.order_id to [GET] Download packing instructions.

Envelope fields#

Field	Type	Description
`id`	string	Event UUID. Primary idempotency key. Matches the `webhook-id` header.
`type`	string	Event type name.
`timestamp`	string	Creation time in ISO 8601 format.
`data`	object	Event-specific fields. Shape depends on `type`.

`packing_instructions.ready`#

This event is sent when packing instructions are ready to download.

`data` fields#

Field	Type	Description
`order_id`	string	ALPHA identifier for the order (same as `alpha_ref` on [GET] Retrieve an order / [GET] List orders).
`reference`	string	Your order reference from submission.

See also#

Download packing instructions

Download the file when this event fires.

[GET] Download packing instructions

Retrieve an order

alpha_ref and reference in API responses.

[GET] Retrieve an order

Verify signatures

Verify webhook-signature before processing.

Verify signatures