Apply Guest Customer to Cart

Next add a guest customer to the cart. The primary purpose of the customer data is to provide the merchant with enough information to communicate with the customer once the order has been submitted.

Required Body Parameters:

first_name - the first name of the customer.
last_name - the last name of the customer.
email - the email address of the customer.

Optional Query Parameters:

shipping_address - the shipping address of the customer.
billing_address - the billing address of the customer.
same_address - use same address for both.


If only one one address is applied and the same_address property is not set to true only one address will be applied to the cart. The remaining address will still need to be applied before the cart can be completed.

curl -X POST{cart_id}/customer \
-H "X-Violet-App-Id: your-app-id-here" \
-H "X-Violet-App-Secret: your-app-secret-here" \
-H "X-Violet-Token: your-token-here" \
-H "Content-type: application/json" \
-d '{"first_name": "Ultra", "last_name": "Violet", "email": "[email protected]"}'


Currently all carts are guest checkout. When our upcoming oAuth system is released you will be able to apply customers who have authorized your application to a cart.