---
title: "customer.address.add"
method: POST
path: "/customer.address.add.json"
tags: ["customer"]
---

# customer.address.add

`POST /customer.address.add.json`

## Request

- Base URL: `https://api.api2cart.com/v1.1`
- URL: `https://api.api2cart.com/v1.1/customer.address.add.json`
- Auth: API key in header `x-api-key` and API key in header `x-store-key`

Add customer address.

## Request body

- CustomerAddressAdd
  - `customer_id` string, required: Defines customer id
  - `store_id` string: Store Id
  - `first_name` string: Defines customer's address first name
  - `last_name` string: Defines customer's address last name
  - `company` string: Defines customer's address company
  - `address1` string, required: Specifies customer's address address1
  - `address2` string: Specifies customer's address address2
  - `city` string, required: Specifies customer's address city
  - `country` string, required: Specifies customer's address ISO code or name of country
  - `state` string: Specifies customer's address ISO code or name of state
  - `postcode` string, required: Specifies customer's address postcode
  - `identification_number` string: Specifies the national ID card number of this person, or a unique tax identification number for customer's address
  - `types` string[]: Specifies customer's address types
  - `default` boolean: Specifies whether the customer's address is used by default
  - `phone` string: Defines customer's address phone number
  - `phone_mobile` string: Defines customer's address mobile phone number
  - `fax` string: Defines customer's address fax
  - `website` string: Defines Link to customer's address website
  - `gender` string: Defines customer's address gender
  - `tax_id` string: Add Tax Id
  - `alias` string: Specifies customer's alias in the address book
  - `idempotency_key` string: A unique identifier associated with a specific request. Repeated requests with the same <strong>idempotency_key</strong> return a cached response without re-executing the business logic. <strong>Please note that the cache lifetime is 15 minutes.</strong>

## Response `200`

successful operation

- object
  - `return_code` integer
  - `return_message` string
  - `result` object
    - `id` string

---

[API](https://skmtc.dev/api2cart/apis/api2cart-openapi.md) · [All operations](https://skmtc.dev/api2cart/apis/api2cart-openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/api2cart/apis/api2cart-openapi/revisions/c34440741693?raw)