Create Customer Address

Create a new address for the authenticated customer.

Authentication

This query requires a valid customer authentication token in the Authorization header. Use the Customer Login API to retrieve the token.

Authorization: Bearer <accessToken>

Arguments

Name	Type	Required	Description
firstName	String	✅ Yes	First name
lastName	String	✅ Yes	Last name
companyName	String	❌ No	Company name
vatId	String	❌ No	VAT identification number
email	String	✅ Yes	Email address
phone	String	✅ Yes	Phone number
address1	String	✅ Yes	Street address line 1
address2	String	❌ No	Street address line 2
city	String	✅ Yes	City
state	String	✅ Yes	State/Province
country	String	✅ Yes	Country code (ISO 3166-1 alpha-2)
postcode	String	✅ Yes	Postal/Zip code
defaultAddress	Boolean	❌ No	Set as default address

Response

Field	Type	Description
addUpdateCustomerAddress	Address	Created address object

Validation Rules

• First name and last name required
• Complete address required
• Valid country code must be provided
• Postal code format depends on country
• Phone number should be in valid format

Related Documentation

• Get Customer Addresses
• Update Customer Address
• Delete Customer Address