---
title: "Add an address to a customer"
method: POST
path: "/accounts/customers/{customerId}/addresses"
tags: ["Customers"]
---

# Add an address to a customer

`POST /accounts/customers/{customerId}/addresses`

## Request

- Base URL: `https://api-sb.meld.io`
- URL: `https://api-sb.meld.io/accounts/customers/{customerId}/addresses`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/meld/apis/bank-linking/docs/accounts/customers/:customerId/addresses/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `customerId` string, required

## Request body

- CreateCustomerAddressRequest
  - `address` CustomerAddressDetailsRequest, required: Address details
    - `city` string, required
    - `countryCode` string, required: Two-letter country code (ISO 3166-1 alpha-2)
    - `firstName` string
    - `lastName` string
    - `lineOne` string, required
    - `lineTwo` string
    - `postalCode` string, required
    - `region` string, required
  - `type` 'BILLING' | 'SHIPPING' | 'RESIDENCE', required: Address type

## Response `200`

Address is created

- CustomerAddress: Customer address
  - `addressDetails` CustomerAddressDetails
    - `addressDetailsFields` object
    - `city` string: City, district, suburb, town, or village
    - `country` string: Two-letter country code (ISO 3166-1 alpha-2)
    - `firstName` string: The first name on the address
    - `lastName` string: The last name on the address
    - `lineOne` string: Address line 1 (e.g., street, PO Box, or company name)
    - `lineTwo` string: Address line 2 (e.g., apartment, suite, unit, or building)
    - `postalCode` string: ZIP or postal code
    - `region` string: State, county, province, or region
  - `customerId` string: Customer id
  - `id` string: Unique identifier for this customer address
  - `status` 'ACTIVE' | 'INACTIVE': Address status
  - `type` 'BILLING' | 'SHIPPING' | 'RESIDENCE': Address type

## Other responses

- `400`: Bad Request : check request values and format
- `401`: Invalid credentials
- `403`: Unauthenticated or authenticated with insufficient access
- `500`: Server Error. This applies to all 5xx errors, including but not limited to 500, 501, 502, 503, and 504 errors. You should treat all of these errors the same.

---

[API](https://skmtc.dev/meld/apis/bank-linking.md) - [All operations](https://skmtc.dev/meld/apis/bank-linking/llms.txt) - [OpenAPI document](https://skmtc.dev/meld/apis/bank-linking/revisions/818d6079a611?raw)