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": "adrian@mienvio.mx",
            "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": "adrian@mienvio.mx",
            "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": "adrian@mienvio.mx",
            "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": "cesar@mienvio.mx",
            "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"
}