Create Address for Logged-In Customer

POST

/store/customers/me/addresses

Create an address for the logged-in customer.

Request Example

Shell

JavaScript

Java

Swift

curl -X POST '{backend_url}/store/customers/me/addresses' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-H 'x-publishable-api-key: {your_publishable_api_key}' \
--data-raw '{
  "metadata": {},
  "first_name": "{value}",
  "last_name": "{value}",
  "phone": "{value}",
  "company": "{value}",
  "address_1": "{value}",
  "address_2": "{value}",
  "city": "{value}",
  "country_code": "{value}",
  "province": "us-ca",
  "postal_code": "{value}",
  "address_name": "{value}"
}'

Response Example

200 - Example 1

{
    "customer": {
        "id": "string",
        "email": "user@example.com",
        "default_billing_address_id": "string",
        "default_shipping_address_id": "string",
        "company_name": "string",
        "first_name": "string",
        "last_name": "string",
        "phone": "string",
        "metadata": {},
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z",
        "addresses": [
            {
                "id": "string",
                "address_name": "string",
                "is_default_shipping": true,
                "is_default_billing": true,
                "customer_id": "string",
                "company": "string",
                "first_name": "string",
                "last_name": "string",
                "address_1": "string",
                "address_2": "string",
                "city": "string",
                "country_code": "usd",
                "postal_code": "string",
                "phone": "string",
                "metadata": {},
                "created_at": "2019-08-24T14:15:22Z",
                "updated_at": "2019-08-24T14:15:22Z",
                "province": "us-ca"
            }
        ]
    }
}

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🔴500Server Error

Modified at 2025-06-17 04:21:30

Update Customer

List Customer's Addresses