Skip to main content
POST

Overview

Sets the shipping address for the cart and automatically retrieves available shipping methods. If no shipping method was previously selected, the lowest cost option is automatically selected.

Authentication

string
required
Device authentication token from browser session

Path Parameters

string
required
Merchant domain (e.g., staging.luma.gift)

Request Body

string
required
Customer’s first name
string
required
Customer’s last name
string
required
Customer’s email address
string
Customer’s phone number (required by some merchants)
string
required
Street address line 1
string
Street address line 2 (apartment, suite, etc.)
string
required
Shipping city
string
required
Postal/ZIP code
string
required
State or province
string
required
Country name (e.g., “United States”)

Response

Returns the cart with shipping information and available shipping methods.

Response Fields

Same as Get Cart response, plus:
object
The shipping address that was set
object
The selected shipping method (auto-selected if none was previously set)
array
Available shipping methods for the given address

Error Responses

400 Bad Request

  • Missing or invalid authentication header
  • No items in cart that require shipping
  • Invalid email format
  • Invalid state for the given country

404 Not Found

Cart not found

412 Precondition Failed

Country not supported by merchant