---
title: "Update a customer"
method: POST
path: "/v1/customers/{id}"
tags: ["Customers"]
---

# Update a customer

`POST /v1/customers/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateCustomerRequest — Fields to update. Note two non-merge behaviors: (1) the name fields (`firstName`, `middleName`, `lastName`) are replaced as a group — if you send any one of them, the others you omit are cleared; (2) `address` is replaced wholesale, not deep-merged — omitted address sub-fields are cleared. Send the complete name set and full address you want to retain.
  - `address` object
    - `line1` string
    - `line2` string
    - `city` string
    - `country` string
    - `state` string
    - `postalCode` union
      - string
      - string
  - `email` string, email
  - `phoneNumber` string
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `dateOfBirth` string
  - `supportedPaymentMethods` string[]

## Response `200`

Success

- object — The updated customer
  - `status` 'SUCCEEDED', required
  - `data` UpdateCustomerResponse, required
    - `id` string, required
    - `referenceId` string, required
    - `email` string
    - `merchantId` string, required
    - `livemode` boolean, required
    - `signupAt` number, required
    - `supportedPaymentMethods` string[]
    - `supportedPayoutMethods` string[]
    - `firstName` string
    - `middleName` string
    - `lastName` string
    - `dateOfBirth` string
    - `phoneNumber` string
    - `address` object
      - `line1` string
      - `line2` string
      - `city` string
      - `state` string
      - `postalCode` string
      - `country` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.dev/breeze/apis/breeze-api.md) · [All operations](https://skmtc.dev/breeze/apis/breeze-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/breeze/breeze-api/revisions/8911892bdf29/schema)