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

# Receive a Delivery Job status update

`POST /webhook_url`

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.net/grubtech/apis/grubtech-auth-server.md) · [All operations](https://skmtc.net/grubtech/apis/grubtech-auth-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grubtech/grubtech-auth-server/versions/21688b6dcb69/schema)