Create an order consumer (legacy)
Important
A newer version of this REST API (v2.1) is available. 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 so you can upgrade.
POST /v2/orders/<orderRef>/consumers
Creates a consumer on an order.
In the response, ref contains the order consumer reference.
RequestResponse
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"
}]
}
}'RequestResponse
{
"href": "<baseURL>/v2/orderConsumers/C439E8B9-53F3-48BB-BD98-EE3657416FBE",
"ref": "C439E8B9-53F3-48BB-BD98-EE3657416FBE",
"createdAt": "2025-08-15T16:00:55.554Z",
"modifiedAt": "2025-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"
}
}