---
title: "Update a customer"
method: PUT
path: "/v0.1/customers/{customer_id}"
tags: ["Customers"]
---

# Update a customer

`PUT /v0.1/customers/{customer_id}`

Updates an identified saved customer resource's personal details.

The request only overwrites the parameters included in the request, all other parameters will remain with their initially assigned values.

## Request body

- object
  - `personal_details` PersonalDetails — Personal details for the customer.
    - `first_name` string — First name of the customer.
    - `last_name` string — Last name of the customer.
    - `email` string — Email address of the customer.
    - `phone` string — Phone number of the customer.
    - `birth_date` string, date — Date of birth of the customer.
    - `tax_id` string — Identification number used for tax purposes, such as a CPF in Brazil.
    - `address` AddressLegacy — Profile's personal address information.
      - `city` string — City name from the address.
      - `country` string — Two letter country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
      - `line_1` string — First line of the address with details of the street name and number.
      - `line_2` string — Second line of the address with details of the building, unit, apartment, and floor numbers.
      - `postal_code` string — Postal code from the address.
      - `state` string — State name or abbreviation from the address.

## Response `200`

Returns the customer resource.

- Customer — Saved customer details.
  - `customer_id` string, required — Unique identifier of the customer.
  - `personal_details` PersonalDetails — Personal details for the customer.
    - `first_name` string — First name of the customer.
    - `last_name` string — Last name of the customer.
    - `email` string — Email address of the customer.
    - `phone` string — Phone number of the customer.
    - `birth_date` string, date — Date of birth of the customer.
    - `tax_id` string — Identification number used for tax purposes, such as a CPF in Brazil.
    - `address` AddressLegacy — Profile's personal address information.
      - `city` string — City name from the address.
      - `country` string — Two letter country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
      - `line_1` string — First line of the address with details of the street name and number.
      - `line_2` string — Second line of the address with details of the building, unit, apartment, and floor numbers.
      - `postal_code` string — Postal code from the address.
      - `state` string — State name or abbreviation from the address.

## Other responses

- `401` — The request is not authorized.
- `403` — The request is authenticated but not permitted for this operation.
- `404` — The requested resource does not exist.

## Changes

- **2026-07-10** `c75ca16e1e44` — 1 info
  - the security scope `customers.write` was added to the endpoint's security scheme `oauth2`
- **2026-03-11** `cd79d83b07e0` — 2 warning, 5 info
  - removed the optional property `error_code` from the response with the `401` status
  - removed the optional property `message` from the response with the `401` status
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `instance` to the response with the `401` status
  - …3 more
- **2025-12-15** `1cc3dc13341a` — 1 breaking
  - request body became required
- **2025-03-29** `040271b0b0c2` — 1 breaking, 6 warning, 9 info
  - the response property `personal_details/address/country` became optional for the status `200`
  - removed the request property `personal_details/address/line1`
  - removed the request property `personal_details/address/line2`
  - removed the request property `personal_details/birthdate`
  - …12 more
- **2025-02-25** `cdadac3315a1` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/customers/:customer_id/put.md)

---

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