Skip to main content
POST
/
checkout
/
guest
/
addresses
Create Guest Address
curl --request POST \
  --url https://api.henrylabs.ai/v0/checkout/guest/addresses \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fullName": "John Doe",
  "email": "john.doe@example.com",
  "phoneNumber": "+1234567890",
  "addressLine1": "350 5th Ave",
  "countryCode": "US",
  "city": "New York",
  "stateOrProvince": "New York",
  "postalCode": "10001",
  "addressLine2": "Apt 1",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "isDefault": true
}
'
{
  "fullName": "John Doe",
  "email": "john.doe@example.com",
  "phoneNumber": "+1234567890",
  "addressLine1": "350 5th Ave",
  "countryCode": "US",
  "city": "New York",
  "stateOrProvince": "New York",
  "postalCode": "10001",
  "addressLine2": "Apt 1",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "isDefault": true
}

Authorizations

​
x-api-key
string
header
required
​
x-access-token
string
header
required

Supabase access token for authentication.

Headers

​
x-user-id
string

Required when authenticating with API key

Body

application/json
​
fullName
string
required

Full name

Minimum string length: 1
Example:

"John Doe"

​
email
string<email>
required

Email

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Example:

"john.doe@example.com"

​
phoneNumber
string
required

Phone number

Minimum string length: 1
Example:

"+1234567890"

​
addressLine1
string
required

Address line 1

Minimum string length: 1
Example:

"350 5th Ave"

​
countryCode
string
required

ISO 3166-1 alpha-2 country code (e.g., 'us', 'uk', 'ca')

Required string length: 2
Example:

"US"

​
city
string
required

City

Minimum string length: 1
Example:

"New York"

​
stateOrProvince
string
required

State or province

Minimum string length: 1
Example:

"New York"

​
postalCode
string
required

Postal code

Minimum string length: 1
Example:

"10001"

​
addressLine2
string | null

Street address line 2 (apartment, suite, etc.)

Example:

"Apt 1"

​
id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

"123e4567-e89b-12d3-a456-426614174000"

​
isDefault
boolean
Example:

true

Response

Guest address created successfully

​
fullName
string
required

Full name

Minimum string length: 1
Example:

"John Doe"

​
email
string<email>
required

Email

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Example:

"john.doe@example.com"

​
phoneNumber
string
required

Phone number

Minimum string length: 1
Example:

"+1234567890"

​
addressLine1
string
required

Address line 1

Minimum string length: 1
Example:

"350 5th Ave"

​
countryCode
string
required

ISO 3166-1 alpha-2 country code (e.g., 'us', 'uk', 'ca')

Required string length: 2
Example:

"US"

​
city
string
required

City

Minimum string length: 1
Example:

"New York"

​
stateOrProvince
string
required

State or province

Minimum string length: 1
Example:

"New York"

​
postalCode
string
required

Postal code

Minimum string length: 1
Example:

"10001"

​
addressLine2
string | null

Street address line 2 (apartment, suite, etc.)

Example:

"Apt 1"

​
id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

"123e4567-e89b-12d3-a456-426614174000"

​
isDefault
boolean
Example:

true