---
title: "Create delivery request"
method: POST
path: "/requests"
tags: ["requests"]
---

# Create delivery request

`POST /requests`

Submit a new delivery request. The `nonce` field provides idempotency.

## Request body

- DeliveryRequest — A delivery request.
  - `id` string, required — Unique request identifier.
  - `nonce` string, required — Client-generated idempotency key.
  - `pickup_location` union, required — A location specified by coordinates and/or postal address. At least one must be provided.
    - object
      - `coordinates` Coordinates, required — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
    - object
      - `coordinates` Coordinates — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress, required
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
  - `dropoff_location` union, required — A location specified by coordinates and/or postal address. At least one must be provided.
    - object
      - `coordinates` Coordinates, required — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
    - object
      - `coordinates` Coordinates — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress, required
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
  - `pickup_time` string, date-time, required — Requested pickup time (RFC 3339).
  - `dropoff_time` string, date-time, required — Requested dropoff time (RFC 3339).
  - `pickup_instructions` string — Pickup directions, access codes, or handling notes.
  - `dropoff_instructions` string — Dropoff directions, access codes, or delivery notes.

## Response `201`

Request created.

- DeliveryRequest — A delivery request.
  - `id` string, required — Unique request identifier.
  - `nonce` string, required — Client-generated idempotency key.
  - `pickup_location` union, required — A location specified by coordinates and/or postal address. At least one must be provided.
    - object
      - `coordinates` Coordinates, required — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
    - object
      - `coordinates` Coordinates — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress, required
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
  - `dropoff_location` union, required — A location specified by coordinates and/or postal address. At least one must be provided.
    - object
      - `coordinates` Coordinates, required — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
    - object
      - `coordinates` Coordinates — Geographic coordinates.
        - `latitude` number, required — Latitude in decimal degrees.
        - `longitude` number, required — Longitude in decimal degrees.
      - `postal_address` PostalAddress, required
        - `extended_address` string — Address extension (apartment number, C/O, etc.).
        - `street_address` string — The street address.
        - `address_locality` string — City or locality.
        - `address_region` string — State, province, or region.
        - `address_country` string — Country (ISO 3166-1 alpha-2 recommended).
        - `postal_code` string — Postal code.
        - `first_name` string — Contact first name.
        - `last_name` string — Contact last name.
        - `phone_number` string — Contact phone number.
  - `pickup_time` string, date-time, required — Requested pickup time (RFC 3339).
  - `dropoff_time` string, date-time, required — Requested dropoff time (RFC 3339).
  - `pickup_instructions` string — Pickup directions, access codes, or handling notes.
  - `dropoff_instructions` string — Dropoff directions, access codes, or delivery notes.

## Other responses

- `400` — Invalid nonce.
- `409` — Duplicate nonce or request ID.
- `422` — Validation errors.

---

[API](https://skmtc.net/palette-labs-inc/apis/local-protocol.md) · [All operations](https://skmtc.net/palette-labs-inc/apis/local-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/palette-labs-inc/local-protocol/revisions/7db6ad75e16d/schema)