---
title: "Create customer address"
method: POST
path: "/customers/{customer_id}/addresses"
tags: ["Customers"]
---

# Create customer address

`POST /customers/{customer_id}/addresses`

Add new customer address

## Request body

- object
  - `fname` string, required — Address first name.
  - `lname` string, required — Address last name.
  - `organization` string — Address organization.
  - `address1` string, required — Address line 1.
  - `address2` string — Address line 2.
  - `city` string, required — Address city.
  - `country` string, required — Address country code, 2 letters (example : US).
  - `state` string — Address state. Required when customers address billing ID is empty and bill_county is US or CA.
  - `zipcode` string, required — Address zipcode.
  - `make_default` boolean — Pass as true to update the address on recurring and pending orders.
  - `orders` integer[] — Pass an array of order ids to update.
  - `address_type` 'shipping' | 'billing' | 'both' — Define which address to update or both. Updating the shipping address on an order will also update any pending shipments associated with the order. Required when passing make_default or orders.

## Response `200`

OK

- object
  - `customer_address_id` integer
  - `fname` string
  - `lname` string
  - `organization` string
  - `address1` string
  - `address2` string
  - `city` string
  - `country` string
  - `state` string
  - `zipcode` string
  - `address_valid` boolean
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `created_by` integer
  - `modified_by` integer

## Other responses

- `400` — Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/versions/62037010356e/schema)
