---
title: "Create Delivery"
method: POST
path: "/delivery-jobs"
tags: ["Logistic Platform Webhooks"]
---

# Create Delivery

`POST /delivery-jobs`

The Create Delivery endpoint is used to enable Grubtech to initiate the creation of a delivery job on the logistics platform. This endpoint will handle details of the delivery request, such as the pickup and drop-off locations, delivery time, and recipient information. Once the delivery job is created, the logistics platform will manage and track the order until it is completed.

## Request body

- DeliveryJobRequest — Details required to create a new delivery job for the order.
  - `id` string, required — Grubtech provided unique id for the relevant delivery job
  - `accountId` string, required — The id of the account this job should be billed to
  - `pickups` Pickup[], required — List of information about pickup details
    - `contactName` string, required — Name of the contact person at the pickup location
    - `contactPhone` string, required — Phone number of person at the pickup location
    - `displayOrderId` string, required — The order id that should be displayed to the driver. The driver should ask for the order using this number when they reach the pickup location. This id is not unique and does not have a consistent pattern.
    - `location` Location, required
      - `address1` string, required — The primary address line for the pickup location.
      - `address2` string — The secondary address line for the pickup location (optional).
      - `area` string, required — The area or neighborhood of the pickup location.
      - `city` string, required — The city where the pickup location is situated.
      - `country` string — The country where the pickup location is situated.
      - `formattedAddress` string, required — A formatted version of the full address.
      - `coordinates` Coordinates, required
        - `latitude` string, required — The latitude of the location.
        - `longitude` string, required — The longitude of the location.
    - `items` Items — Brief information about Order menu item related to the delivery.
      - `name` string, required — Name of the item. <br><i>Example: Hot Butter Cuttlefish</i>
      - `quantity` string, required — Quantity of the delivery item
  - `dropOffs` DropOff[], required — List of information about drop-off details
    - `contactName` string, required — Name of the customer at the drop-off. <br><i>Example: Mark</i>
    - `contactPhone` string, required — Contact number of the customer at the drop-off.<br> <i>Example: 9474323232323</i>
    - `location` Location, required
      - `address1` string, required — The primary address line for the pickup location.
      - `address2` string — The secondary address line for the pickup location (optional).
      - `area` string, required — The area or neighborhood of the pickup location.
      - `city` string, required — The city where the pickup location is situated.
      - `country` string — The country where the pickup location is situated.
      - `formattedAddress` string, required — A formatted version of the full address.
      - `coordinates` Coordinates, required
        - `latitude` string, required — The latitude of the location.
        - `longitude` string, required — The longitude of the location.
    - `payment` Payment, required
      - `mode` 'CARD' | 'CASH' | 'PREPAID', required — Specifies the method of payment for the delivery order. It indicates how the payment will be handled at the time of delivery.
      - `amount` integer, required — The total amount to be collected at delivery.
      - `currencyCode` string, required — The currency of the payment, in ISO 4217 format (e.g., USD, AED).
  - `preparedAt` string — Order prepared time.This should be in date-time format
  - `scheduledAt` string — Date and time which the schedule order is ready to be delivered.This should be in date-time format

## Response `202`

Successful response OK

- CreateDeliveryResponse — Response object of the successful order creation
  - `referenceId` string, required — Unique id for the created delivery job
  - `status` string, required — Status of the created delivery job

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[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/revisions/21688b6dcb69/schema)