POST
/
api
/
ext
/
v1
/
collection
/
{collectionId}
/
orders
curl --request POST \
  --url https://staging-api.covver.io/api/ext/v1/collection/{collectionId}/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "companyId": "<string>",
  "isVip": true,
  "user": {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>"
  },
  "orderItems": [
    {
      "variantId": "<string>",
      "quantity": 123
    }
  ],
  "taxNumber": "<string>",
  "customAttributes": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "address": {
    "address1": "<string>",
    "city": "<string>",
    "countryCode": "<string>",
    "phone": "<string>",
    "province": "<string>",
    "provinceCode": "<string>",
    "customAttributes": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "address2": "",
    "zip": "",
    "country": "<string>"
  },
  "note": "<string>",
  "personalizations": {
    "firstName": "<string>",
    "lastName": "<string>",
    "department": "<string>",
    "location": "<string>",
    "startDate": "2023-11-07T05:31:56Z",
    "birthDate": "2023-11-07T05:31:56Z"
  },
  "externalId": "<string>",
  "shouldSendEmail": true,
  "shouldValidateProvinceCode": true
}'
{
  "order": {
    "id": "<string>",
    "orderNumber": "<string>"
  }
}
See List of countries
Pass in the user’s details for personalized items. See personalization guide for more details

​
International pricing

NOTE! Some products have a priceDeltaByCountry field that will affect the price of the product when shipped internationally. If you pass countryCode when getting the product you will get the price after applying the delta. If you don’t pass countryCode you should apply the delta yourself based on the recipient’s address

​
Tax number

For Brazil, China, Italy, and South Korea you must pass in an additional taxNumber field. For Brazil the tax number field must pass regex validation as follows

new RegExp(`^\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}$`).test(taxNumber)

For China, Italy, and South Korea there is no validation run on the taxNumber field.

​
Personalization

To order a product with personalization the personalized product must first be created via the getProduct or listProducts endpoints

​
CustomAttributes

Custom attribute field is deprecated. Please use the taxNumber field instead

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
collectionId
string
required

Body

application/json
​
user
object
required
​
orderItems
object[]
required
​
address
object
required
​
companyId
string
​
isVip
boolean
​
taxNumber
string
​
customAttributes
object[]
​
note
string
​
personalizations
object
​
externalId
string
​
shouldSendEmail
boolean
default:
true
​
shouldValidateProvinceCode
boolean

Response

200
application/json
Default Response
​
order
object
required
Validate an orderOrder status