---
title: "Create an authenticated customer address"
method: POST
path: "/v3/stores/{store_id}/customers/me/addresses"
tags: ["Customer Account"]
---

# Create an authenticated customer address

`POST /v3/stores/{store_id}/customers/me/addresses`

## Request

- Base URL: `https://api.scalev.com`
- URL: `https://api.scalev.com/v3/stores/{store_id}/customers/me/addresses`
- Auth: HTTP bearer

Customer-authenticated storefront endpoint.

## Request body

- CustomerAddressRequest
  - `name` string
  - `phone` string
  - `email` string, email
  - `location_id` union
    - integer
    - string
  - `address` string
  - `postal_code` string
  - `notes` string

## Response `200`

Customer address

- CustomerAddress
  - `id` union
    - integer
    - string
  - `name` string, nullable
  - `phone` string, nullable
  - `email` string, email, nullable
  - `location` object, nullable
    - `id` integer
    - `subdistrict_name` string
    - `city_name` string
    - `province_name` string
    - `kelurahan_name` string, nullable
  - `address` string, nullable
  - `postal_code` string, nullable
  - `notes` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

## Changes

- **2026-10-22** `b4add50bab84`: 1 info
  - added the optional property `location/kelurahan_name` to the response with the `200` status

[Operation history](https://skmtc.dev/scalev/apis/nexus-commerce-api/changes/v3/stores/:store_id/customers/me/addresses/post.md)

---

[API](https://skmtc.dev/scalev/apis/nexus-commerce-api.md) - [All operations](https://skmtc.dev/scalev/apis/nexus-commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalev/apis/nexus-commerce-api/revisions/6b9152f04622?raw)