---
title: "Create Delivery"
method: POST
path: "/relay/delivery"
tags: ["Relay Delivery"]
---

# Create Delivery

`POST /relay/delivery`

Initiate a new relay delivery using a fee ID from the Get Delivery Fee endpoint.

## Request body

- object
  - `destination_contact` object, required
    - `name` string, required — Name of the person receiving the package
    - `phone` string, required — 11 digit phone number of the destination contact
    - `country_code` string, required — ISO 3166-1 alpha-2 Country Code
    - `email` string — Email address of the destination contact
  - `source_contact` object, required
    - `name` string, required — Name of the destination contact
    - `phone` string, required — 11 digit phone number of the destination contact
    - `country_code` string, required — ISO 3166-1 alpha-2 Country Code of the destination contact phone number
    - `email` string — Email address of the destination contact
  - `fee_id` integer, required — ID of the fee returned from the previous step
  - `item_type` string, required
  - `user_action` 'sending' | 'receiving', required — Use "sending" when the source contact is the one making this request or "receiving" when the destination contact is the one making this request
  - `reference` string — Unique reference to identify the delivery, if reference is not provided, we will automatically generate one
  - `estimated_order_amount` integer
  - `customer_delivery_note` string — Leave a note for the delivery person e.g handle with care

## Response `200`

200

- object
  - `status` string
  - `message` string
  - `data` object
    - `reference` string
    - `id` integer
    - `delivery_price` integer
    - `status` string
    - `made_payment` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.dev/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/revisions/5830cc8467d8/schema)