---
title: "Create Delivery"
method: POST
path: "/merchant/{merchantReference}/delivery"
tags: ["Delivery"]
---

# Create Delivery

`POST /merchant/{merchantReference}/delivery`

Initiate a new delivery request. Provide source and destination contact details, delivery notes, the fee ID from a prior fee quote, and order information.

## Path parameters

- `merchantReference` string, required

## Request body

- object
  - `destination_contact` object, required — Details of the person receiving the delivery.
    - `name` string, required — Full name of the destination contact.
    - `phone` string, required — Phone number of the recipient.
    - `email` string — Email address of the recipient.
    - `country_code` string — Country code (e.g., "NG").
  - `source_contact` object, required — Details of the person initiating/sending the delivery.
    - `name` string, required — Full name of the sender.
    - `phone` string, required — Phone number of the sender.
    - `email` string — Email address of the sender.
    - `country_code` string — Country code (e.g., "NG").
  - `customer_delivery_note` string — Special delivery instructions for the rider (e.g., “Handle with care”).
  - `customer_vendor_note` string — Notes from the vendor about the package (e.g., “Fragile items inside”).
  - `fee_id` integer, required — ID of the delivery fee (from the delivery estimate endpoint).
  - `item_type` string, required — Type of item being delivered (e.g., phone, documents).
  - `user_action` string, required — Indicates if user is sending or receiving.
  - `reference` string — Optional unique reference for the delivery.
  - `estimated_order_amount` integer — Estimated value of the order (set to 0 if not applicable).

## Response `200`

---

[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)