{
"action": "parcel_status_changed",
"timestamp": 123,
"carrier_status_change_timestamp": 123,
"parcel": {
"id": 1,
"name": "Mr Bob",
"company_name": "Sendcloud",
"address": "Stadhuisplein 10",
"address_divided": {
"street": "Stadhuisplein",
"house_number": 10
},
"city": "Eindhoven",
"postal_code": "5611 EM",
"telephone": "612345678",
"email": "contact@sendcloud.com",
"date_created": "03-02-2019 06:48:07",
"tracking_number": "3SYZXG132912330",
"weight": "2.000",
"label": {
"normal_printer": [
"https://panel.sendcloud.sc/api/v2/label/normal_printer/3172?start_from=0&hash=bbfd669ee9ebb19408b85b33d181a50040fd9bc4"
],
"label_printer": "https://panel.sendcloud.sc/api/v2/label/label_printer/3172?hash=bbfd669ee9ebb19408b85b33d181a50040fd9bc4"
},
"customs_declaration": {},
"status": {
"id": 1,
"message": "Ready to send"
},
"data": {},
"country": {
"iso_3": "NLD",
"iso_2": "NL",
"name": "Netherlands"
},
"shipment": {
"id": 1,
"name": "PostNL Standard"
},
"order_number": "ORD12334",
"shipment_uuid": "87e18823-016b-479b-b9e0-c5c0c4065452",
"external_order_id": "AMZ23311",
"external_shipment_id": "AMZ231231",
"tracking_url": "https://tracking.eu-central-1-0.sendcloud.sc/forward?carrier=postnl&code=3SYZXG132912330&destination=NL&lang=en-us&source=NL&type=parcel&verification=5611+AB",
"delivery_dates": {
"handover_at": "2026-09-25T10:00:00Z",
"deliver_at": null
},
"carrier": {
"id": null,
"code": "postnl",
"name": "PostNL",
"servicepoints_carrier_code": "postnl"
},
"is_return": false,
"date_updated": "03-02-2019 06:48:07",
"date_announced": "03-02-2019 06:50:12",
"colli_uuid": "d451ccef-1f1a-43a9-afd1-34bb13004700",
"collo_nr": 0,
"collo_count": 1
}
}Webhooks (payload reference)
Parcel status changed
Happens whenever a parcel belonging to this integration shifts to a different status. Only parcels created through this specific integration will trigger this webhook.
WEBHOOK
ParcelStatusChanged
{
"action": "parcel_status_changed",
"timestamp": 123,
"carrier_status_change_timestamp": 123,
"parcel": {
"id": 1,
"name": "Mr Bob",
"company_name": "Sendcloud",
"address": "Stadhuisplein 10",
"address_divided": {
"street": "Stadhuisplein",
"house_number": 10
},
"city": "Eindhoven",
"postal_code": "5611 EM",
"telephone": "612345678",
"email": "contact@sendcloud.com",
"date_created": "03-02-2019 06:48:07",
"tracking_number": "3SYZXG132912330",
"weight": "2.000",
"label": {
"normal_printer": [
"https://panel.sendcloud.sc/api/v2/label/normal_printer/3172?start_from=0&hash=bbfd669ee9ebb19408b85b33d181a50040fd9bc4"
],
"label_printer": "https://panel.sendcloud.sc/api/v2/label/label_printer/3172?hash=bbfd669ee9ebb19408b85b33d181a50040fd9bc4"
},
"customs_declaration": {},
"status": {
"id": 1,
"message": "Ready to send"
},
"data": {},
"country": {
"iso_3": "NLD",
"iso_2": "NL",
"name": "Netherlands"
},
"shipment": {
"id": 1,
"name": "PostNL Standard"
},
"order_number": "ORD12334",
"shipment_uuid": "87e18823-016b-479b-b9e0-c5c0c4065452",
"external_order_id": "AMZ23311",
"external_shipment_id": "AMZ231231",
"tracking_url": "https://tracking.eu-central-1-0.sendcloud.sc/forward?carrier=postnl&code=3SYZXG132912330&destination=NL&lang=en-us&source=NL&type=parcel&verification=5611+AB",
"delivery_dates": {
"handover_at": "2026-09-25T10:00:00Z",
"deliver_at": null
},
"carrier": {
"id": null,
"code": "postnl",
"name": "PostNL",
"servicepoints_carrier_code": "postnl"
},
"is_return": false,
"date_updated": "03-02-2019 06:48:07",
"date_announced": "03-02-2019 06:50:12",
"colli_uuid": "d451ccef-1f1a-43a9-afd1-34bb13004700",
"collo_nr": 0,
"collo_count": 1
}
}Authorizations
Body
application/json
Webhook data you will receive
The webhook payload when a parcel (either an outgoing or an incoming one) changes status.
Describes the webhook action
Available options:
parcel_status_changed Example:
"parcel_status_changed"
A unix timestamp indicating the time that the status changed
A unix timestamp indicating the time that the status changed in the carrier's system
Parcel object
Show child attributes
Show child attributes
Response
200
Return a 200 status to indicate that the data was processed successfully. The response body may contain the extended line item.