---
title: "Create an order consumer (legacy)"
slug: "create-an-order-consumer--legacy-"
abstract: "Describes how to create an order consumer using the Sitecore CDP Order consumer REST API."
---
# Create an order consumer (legacy)

> [!important]
> [A newer version of this REST API (v2.1) is available](https://api-docs.sitecore.com/cdp/order-rest-api). If you're new to this REST API, use the new version. Alternatively, if you're already using the old version, [read about the differences between v2 and v2.1](https://doc.sitecore.com/cdp/en/developers/api/rest-apis/legacy-rest-apis/order-consumer-rest-api-v2--legacy-/differences-between-v2-and-v2-1-of-the-order-rest-apis.html "Differences between v2 and v2.1 of the Order REST APIs") so you can upgrade.

`POST /v2/orders/<orderRef>/consumers`

Creates a consumer on an order.

| Attribute | Type | Description | Example |
| --- | --- | --- | --- |
| `orderRef` | string | The reference of the order.<br><br>If you do not know the order reference, first [retrieve orders](https://doc.sitecore.com/cdp/en/developers/api/rest-apis/legacy-rest-apis/order-consumer-rest-api-v2--legacy-/retrieve-orders--legacy-.html). | `d680c9be-4c07-4731-857e-9602034b15f2` |

At a minimum, you must provide the following required attributes in the request body:

| Attribute | Type | Description | Example |
| --- | --- | --- | --- |
| `firstName` | string (title case recommended) | The first name of the order consumer. | `"John"` |
| `lastName` | string (title case recommended) | The last name of the order consumer. | `"Doe"` |

In the response, `ref` contains the order consumer reference.

```curl
curl -X POST <baseURL>/v2/orders/d680c9be-4c07-4731-857e-9602034b15f2/consumers' \
-u '<username>:<password>' \
-H 'Accept: application/json' \
--data-raw '{
    "title": "Mr",
    "firstName": "John",
    "lastName": "Doe",
    "gender": "male",
    "guest": {
       "href": "<baseURL>/v2/guests/567A697E-4E79-4F2C-96D1-A7249A44744F"
    },
    "orderItems": {
       "items" : [{
            "href": "<baseURL>/v2/orderItems/FECBB7ED-6DFE-4E8C-85A9-B894B17EF4F3"
         }]
    }
}'

```

```json
{
    "href": "<baseURL>/v2/orderConsumers/C439E8B9-53F3-48BB-BD98-EE3657416FBE",
    "ref": "C439E8B9-53F3-48BB-BD98-EE3657416FBE",
    "createdAt": "2026-08-15T16:`00:55`.554Z",
    "modifiedAt": "2026-08-21T16:`00:51`.882Z",
    "title": "Mr",
    "firstName": "John",
    "lastName": "Doe",
    "gender": "male",
    "guest": {
       "href": "<baseURL>/v2/guests/567A697E-4E79-4F2C-96D1-A7249A44744F"
    },
    "orderItems": {
       "items" : [{
             "href": "<baseURL>/v2/orderItems/FECBB7ED-6DFE-4E8C-85A9-B894B17EF4F3"
        }]
   },
    "order": {
       "href": "<baseURL>/v2/orders/056621C2-C955-492D-B7EE-C77C6BDDFDEE"
    }
}

```