**Version: 202601**

# Create address

**POST** `/openapi/2026-01/customers/:customer_id/addresses`

Create a new address with the provided details.

## Request

**Path Parameters**

- `customer_id` string (required)

  Customer ID

**application/json**

**Body | Example**

**Body (required)**

- `address` object (required)

  Address

  - `country` string (required)

    Country name of the address, required at least 1 character. e.g "China"
  - `country_code` string (required)

    ISO country code, required at least 1 character, e.g "CN" for China
  - `first_name` string

    The first name of the person receiving the shipment or package
  - `last_name` string

    The last name of the person receiving the shipment or package
  - `address1` string

    This field represents the main address line, such as the house number and street name. It is used to specify the primary location of the address
  - `address2` string

    This field represents an additional address line, such as an apartment number or suite number. It is used to provide more specific information about the location of the address
  - `area` string

    Area or region of the address
  - `city` string

    City of the address. This field specifies the name of the city or town where the address is located
  - `province` string

    Province or state of the address. This field specifies the administrative division or region within a country
  - `province_code` string

    Province code of the address. This field specifies the abbreviated or standardized code representing the province or state
  - `company` string

    Company name associated with the address
  - `phone` string

    Phone number associated with the consignee
  - `phone_area_code` string

    Area code for the phone number. This field specifies the code used to identify a specific geographic area for telephone calls
  - `zip` string

    Postal or ZIP code of the address. This field specifies the code used to identify a specific geographic area for mail delivery
  - `gender` string

    Gender of the person, optional field. Acceptable values are "male" and "female"
  - `email` string

    Email address for the consignee. This field is used to specify the email address of the person receiving the shipment or package
  - `default` boolean

    Indicates if this is the default address. "true" if this is the first address created for the user, otherwise "false"

```json
{
  "address": {
    "country": "string",
    "country_code": "string",
    "first_name": "string",
    "last_name": "string",
    "address1": "string",
    "address2": "string",
    "area": "string",
    "city": "string",
    "province": "string",
    "province_code": "string",
    "company": "string",
    "phone": "string",
    "phone_area_code": "string",
    "zip": "string",
    "gender": "string",
    "email": "string",
    "default": true
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `address` object

    Address

    - `id` string

      Address ID
    - `customer_id` string

      ID of the customer this address belongs to
    - `first_name` string

      First name of the consignee
    - `last_name` string

      Last name of the consignee
    - `company` string

      Company name
    - `city` string

      City of the address
    - `province` string

      Province or state of the address
    - `country` string

      Country name of the address
    - `zip` string

      Postal or ZIP code
    - `province_code` string

      Province code
    - `country_code` string

      ISO country code
    - `gender` string

      Gender of the consignee
    - `phone` string

      Phone number associated with the address
    - `phone_area_code` string

      Area code of the phone number
    - `area` string

      Area or region of the address
    - `email` string

      Email associated with the address
    - `name` string

      Full name of the consignee
    - `address1` string

      Primary street address
    - `address2` string

      Secondary street address
    - `country_name` string

      Full name of the country
    - `default` boolean

      Indicates if this is the default address

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "address": {
      "id": "string",
      "customer_id": "string",
      "first_name": "string",
      "last_name": "string",
      "company": "string",
      "city": "string",
      "province": "string",
      "country": "string",
      "zip": "string",
      "province_code": "string",
      "country_code": "string",
      "gender": "string",
      "phone": "string",
      "phone_area_code": "string",
      "area": "string",
      "email": "string",
      "name": "string",
      "address1": "string",
      "address2": "string",
      "country_name": "string",
      "default": true
    }
  }
}
```