You can register for webhooks from your Settings > Integrations.
This documentation is for webhooks version 2.
You can receive webhooks for:
- New shipments.
- Updates to a shipment's status.
Webhooks keep the same data format.
Here is an example for a new shipment.
{
"type": "shipment.label_created",
"version": "2.0",
"trigger_time": "2025-07-03 23:44:24",
"code": 104,
"description": "LABEL_CREATED",
"shipment": {
"shipment_id": 6793311,
"owner_id": 51306,
"weight": 1,
"length": 17,
"width": 2,
"height": 14,
"volumetric_weight": "0.10",
"real_weight": 0,
"real_volumetric_weight": 0,
"real_length": 0,
"real_width": 0,
"real_height": 0,
"declared_value": 100,
"description": "Armazones para tarjetas",
"external_order_id": null,
"created_at": "2025-07-03 23:44:03",
"updated_at": "2025-07-03 21:44:24",
"address_from": {
"address_id": 12582535,
"name": "Adrian Camiruaga",
"email": "[email protected]",
"phone": "3330573757",
"tax_id_number": "CATS990413B93",
"street": "C. Lucerna 19",
"street2": "Juarez",
"reference": "Frente a Ctro Integrador Bienestar",
"zipcode": "06600",
"city_municipality": "Cuauht\u00e9moc",
"state": "Ciudad de M\u00e9xico",
"country": "MX"
},
"address_to": {
"address_id": 12303623,
"name": "SERGIO ADRIAN Camiruaga",
"email": "[email protected]",
"phone": "3313156454",
"tax_id_number": "XAXX010101000",
"street": "Av Asd Mweg #2323",
"street2": "Asfasgfasf",
"reference": "",
"zipcode": "44920",
"city_municipality": "Guadalajara",
"state": "Jalisco",
"country": "MX"
},
"label": {
"label_id": 1929435,
"tracking_number": "300000000011270006K6G2",
"label_url": "https:\/\/s3.amazonaws.com\/mienvio\/1751604262559535000_51306_300000000011270006K6G2.pdf",
"mienvio_tracking_url": "https:\/\/tracking.mienvio.mx\/300000000011270006K6G2",
"created_at": "2025-07-03 21:44:24"
},
"purchase": {
"purchase_id": 2186647,
"amount": 642.26,
"status": "PAYED",
"payment_id": "mienvio_wallet_ijpe0LmIbz1751604255_51306",
"created_at": "2025-07-03 23:44:14"
},
"rate": {
"rate_id": 13831024,
"provider": "Estafeta",
"service_name": "estandar",
"provider_img": "http:\/\/mienvio.test\/media\/providers\/Estafeta.svg",
"currency": "MXN",
"duration_terms": "5 a 12 d\u00edas h\u00e1biles",
"days": 10
}
},
"events": []
}Example of a webhook for a shipment status change.
{
"version": "2.0",
"trigger_time": "2025-07-03 09:30:55",
"code": "400",
"description": "ENTREGADO",
"shipment": {
"shipment_id": 6793308,
"owner_id": 51306,
"weight": 0,
"length": 10,
"width": 10,
"height": 10,
"volumetric_weight": "0.20",
"real_weight": 0,
"real_volumetric_weight": 0,
"real_length": 0,
"real_width": 0,
"real_height": 0,
"declared_value": 250,
"description": "Armazones para tarjetas",
"external_order_id": "",
"created_at": "2025-07-03T17:45:13Z",
"updated_at": "2025-07-03T20:30:35Z",
"address_from": {
"address_id": 12582535,
"name": "Adrian Camiruaga",
"email": "[email protected]",
"phone": "3330573757",
"tax_id_number": "CATS990413B93",
"street": "C. Lucerna 19",
"street2": "Juarez",
"reference": "Frente a Ctro Integrador Bienestar",
"zipcode": "06600",
"city_municipality": "Cuauhtémoc",
"state": "Ciudad de México",
"country": "MX"
},
"address_to": {
"address_id": 11865706,
"name": "Cesar Martinez",
"email": "[email protected]",
"phone": "+523319654050",
"tax_id_number": "XAXX010101000",
"street": "Isla Salomon 2600 Int 2 Jardines",
"street2": "Del Sur 2",
"reference": "asdsadsad",
"zipcode": "44950",
"city_municipality": "Guadalajara",
"state": "Jalisco",
"country": "MX"
},
"label": {
"label_id": 1929434,
"tracking_number": "105590504665570A025WWB",
"mienvio_tracking_url": "https://tracking.mienvio.mx/105590504665570A025WWB",
"label_url": "https://tracking.mienvio.mx/700000000011270006K6CM",
"created_at": "2025-07-03T15:47:13Z"
},
"purchase": {
"purchase_id": 2186646,
"amount": 642.26,
"status": "PAYED",
"payment_id": "mienvio_wallet_eQWGtEmFYx1751582825_51306",
"created_at": "2025-07-03T17:47:05Z"
},
"rate": {
"rate_id": 13831024,
"provider": "Estafeta",
"service_name": "estandar",
"provider_img": "/media/providers/Estafeta.svg",
"currency": "MXN",
"duration_terms": "5 a 12 días hábiles",
"days": 10
},
"events": [
{
"date": "2025-07-04",
"time": "03:31:32",
"date_time": "2025-06-23 18:32:00",
"description": "Recibido por Estafeta",
"code": "on_transit",
"area": "MEXICO SUR",
"is_service_incident": false,
"is_pickup_exception": false,
"is_in_return_process": false
},
{
"date": "2025-07-04",
"time": "03:31:32",
"date_time": "2025-06-25 08:22:00",
"description": "En Tránsito",
"code": "on_transit",
"area": "SN. MIGUEL ALLENDE",
"is_service_incident": false,
"is_pickup_exception": false,
"is_in_return_process": false
},
{
"date": "2025-07-04",
"time": "03:31:32",
"date_time": "2025-06-25 11:05:00",
"description": "En Proceso de Entrega a Domicilio",
"code": "on_transit",
"area": "SN. MIGUEL ALLENDE",
"is_service_incident": false,
"is_pickup_exception": false,
"is_in_return_process": false
},
{
"date": "2025-07-04",
"time": "03:31:32",
"date_time": "2025-06-25 18:39:00",
"description": "Entregado",
"code": "on_transit",
"area": "SN. MIGUEL ALLENDE",
"is_service_incident": false,
"is_pickup_exception": false,
"is_in_return_process": false
}
]
}
}Example of a webhook for a shipment manual label.
{
"type": "shipment.manual_label",
"version": "2.0",
"trigger_time": "2026-02-12 15:42:59",
"code": 112,
"description": "MANUAL_LABEL",
"shipment": {
"shipment_id": 7215176,
"owner_id": 51306,
"purchase_id": 2398781,
"provider": "99 Minutos",
"service_name": "estandar",
"weight": 1,
"length": 1,
"width": 1,
"height": 1,
"description": "Carcasa de motor",
"external_order_id": null,
"created_at": "2026-02-12 14:13:41",
"updated_at": "2026-02-12 15:42:59"
},
"label_error_details": "{\n \"error\": \"Something crashed when processing label\",\n \"shipment_id\": 7215176,\n \"timestamp\": \"2026-02-12T21:42:59.040299Z\",\n"
}