---
title: "Create a new delivery job"
method: POST
path: "/{aplicationId}/delivery-jobs"
---

# Create a new delivery job

`POST /{aplicationId}/delivery-jobs`

This endpoint is used to create ad-hoc or customized delivery jobs and provide flexibility in fleet management.

## Path parameters

- `aplicationId` string, required

## Request body

- DeliveryJob
  - `id` string, required — A unique identifier assigned to each delivery job.
  - `storeId` string, required — The unique identifier for the store associated with the delivery job.
  - `orderReferenceId` string, required — A unique identifier that refers to the order being delivered.
  - `item` Item[], required — A list of items to be delivered. Each object contains details of an individual item.
    - `name` string, required — The name or description of the item to be delivered.
    - `quantity` integer, required — The quantity of the specific item to be delivered.
  - `pickup` PickupOrDropOff
    - `contactName` string, required — The name of the person at the drop-off location.
    - `contactPhone` string, required — The contact phone number of the person at the drop-off location.
    - `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.
    - `notes` string — Any additional instructions for the delivery, such as security gate codes or preferred drop-off instructions.
  - `dropOff` ExtendedPickupOrDropOff, required
    - `contactName` string, required — The name of the person at the drop-off location.
    - `contactPhone` string, required — The contact phone number of the person at the drop-off location.
    - `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.
    - `notes` string — Any additional instructions for the delivery, such as security gate codes or preferred drop-off instructions.
    - `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, required — Represents the timestamp when the order was fully prepared and ready for pickup. It follows the ISO 8601 format (e.g., 2025-01-29T14:30:00Z). This helps coordinate the pickup timing with the courier.
  - `scheduledAt` string — Represents the timestamp when the delivery is planned to take place. It follows the ISO 8601 format (e.g., 2025-01-29T15:00:00Z). This helps coordinate the expected delivery time with the recipient.
  - `deliveryPartnerId` string — A unique ID for the delivery service handling the order. It helps track which third-party provider is responsible for the delivery.

## Response `201`

Delivery job created 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/revisions/21688b6dcb69/schema)