---
title: "Create customer upSell order"
method: POST
path: "/orders/upsell"
tags: ["Order Controller"]
---

# Create customer upSell order

`POST /orders/upsell`

Allows customers to purchase recommended products. Fetches details from parent order. No authentication required.

## Request body

- CreateUpSellOrderDto
  - `parentOrderId` number, required — Parent order ID to fetch customer and shipping details
  - `productIds` number[], required — Array of product IDs to purchase as upsell
  - `upSellSource` 'ORDER' | 'EMAIL' | 'ADMIN' | 'Document Link' — Source of the upsell order
  - `orderLng` 'en' | 'fr' | 'es' — Order language
  - `suburb` string — Property suburb
  - `shippingAddress1` string — Shipping address line 1
  - `shippingAddress2` string — Shipping address line 2
  - `shippingCity` string — Shipping city
  - `shippingPostcode` string — Shipping postcode
  - `shippingCounty` string — Shipping county
  - `shippingPhone` string — Shipping phone number
  - `shippingFirstName` string — Shipping first name
  - `shippingLastName` string — Shipping last name
  - `hasSwimmingPool` boolean — Whether property has a swimming pool
  - `instrumentCopyNumber` string — Instrument copy number (optional)

## Response `201`

UpSell order created successfully

- OrderCreateUpdateResponseDto
  - `orderId` number, required — Order ID
  - `customerEmail` string, required — Customer email
  - `emailValid` boolean, required — Email valid
  - `emailValidationStatus` string — Email validation status (UNKNOWN, VALID, INVALID)
  - `isNewCustomer` boolean — True if customer was auto-created during this order
  - `documentAccessLink` string — Permanent document access link

---

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