---
title: "Receive a Delivery Job status update"
method: POST
path: "/external_system_webhook"
---

# Receive a Delivery Job status update

`POST /external_system_webhook`

## Request

- Base URL: `https://api.staging.grubtech.io/lai`
- URL: `https://api.staging.grubtech.io/lai/external_system_webhook`
- Auth: none declared

This endpoint is used to facilitate communication between an external delivery system and Grubtech by delivering real-time updates about delivery job statuses.

## Request body

- StatusUpdate
  - `eventType` string
  - `data` object
    - `id` string
    - `courier` Courier
      - `trackingId` string: A unique identifier assigned to the delivery for tracking purposes.
      - `trackingUrl` string: A URL that provides real-time tracking information for the delivery.
      - `driverId` string: A unique identifier assigned to the delivery driver.
      - `driverName` string: The name of the delivery driver.
      - `driverMobileNumber` string: The mobile phone number of the delivery driver.
      - `pickUpAt` string: The timestamp (ISO 8601 format) indicating when the courier picked up the order from the pickup location.
    - `status` string
    - `cancellationReason` string: A descriptive reason for why the delivery job is being canceled. This information can be used for tracking and reporting purposes (e.g., "Customer request", "Driver unavailable", or "Invalid address").

## Response `200`

Delivery job status updated successfully

---

[API](https://skmtc.dev/grubtech/apis/delivery-management-api.md) - [All operations](https://skmtc.dev/grubtech/apis/delivery-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grubtech/apis/delivery-management-api/revisions/0e87d9c77ed5?raw)