---
title: "Update Customer by ID"
method: POST
path: "/customers/{customerId}"
tags: ["customers"]
---

# Update Customer by ID

`POST /customers/{customerId}`

## Request

- Base URL: `https://sandbox.trustly.one/api/v1`
- URL: `https://sandbox.trustly.one/api/v1/customers/{customerId}`
- Auth: HTTP basic

Updates the specified Customer by setting the values of the parameters on the customer object passed. Before calling this endpoint, it may be beneficial to call [Get Customer by ID](/api-reference/api/customers/get-customers-customer-id) to obtain a Customer Object. Change the desired fields in the Customer object and then modify the object before calling the update endpoint with the modified object.

## Path parameters

- `customerId` string, required

## Request body

- Customer: The Trustly customer object, containing identification details and contact information.
  - `name` string, required: Full name of the Customer
  - `taxId` string: Customer tax ID (e.g. SSN [US], SIN [CA]). *May be required depending on industry and location.*
  - `address` Address, required: Valid mailing or billing address associated with the customer
    - `address1` string: Address line 1 (e.g., street or PO Box)
    - `address2` string: Address line 2 (e.g., apartment, suite or unit number)
    - `city` string: City, district, town or village
    - `state` string: State, province or region code
    - `zip` string: ZIP or Postal Code
    - `country` string, required: 2 character [ISO Country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
  - `phone` string, required: Customer phone number.
  - `email` string, required: Customer email address.
  - `dateOfBirth` string: Customer date of birth.
  - `createdAt` integer: The record created date and time as a UNIX timestamp.
  - `updatedAt` integer: The record created date and time as a UNIX timestamp.
  - `customerId` string: A unique Trustly customer identifier.
  - `externalId` string: A unique merchant customer identifier.
  - `merchantId` string: A unique Trustly merchant identifier.
  - `enrollDate` integer: Date of the user's first transaction in your system, regardless of payment method used as a UNIX timestamp.
  - `vip` string: Range that determines how low-risk the customer represents to the merchant
  - `currency` string: Customer currency.
  - `balance` string: Customer account balance (not associated with a financial institution account).
  - `organizationNumber` string: Organization number for business accounts
  - `externalTier` string: It should describe the customer''s rank to the merchant (e.g. Gold, Diamond, 4 stars, etc.)
  - `personId` string: Unique customer identity throughout different banks.
  - `customData` CustomerCustomData: Object for sending merchant-specific custom data.
  - `driverLicense` DriverLicense
    - `number` string, required: Driver License number.
    - `state` string, required: 2 character ISO State code.
  - `nationalId` string: Customer National ID

## Response `200`

OK

- CustomersPostCustomersCustomerIdResponse200
  - `customer` Customer: The Trustly customer object, containing identification details and contact information.
    - `name` string, required: Full name of the Customer
    - `taxId` string: Customer tax ID (e.g. SSN [US], SIN [CA]). *May be required depending on industry and location.*
    - `address` Address, required: Valid mailing or billing address associated with the customer
      - `address1` string: Address line 1 (e.g., street or PO Box)
      - `address2` string: Address line 2 (e.g., apartment, suite or unit number)
      - `city` string: City, district, town or village
      - `state` string: State, province or region code
      - `zip` string: ZIP or Postal Code
      - `country` string, required: 2 character [ISO Country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
    - `phone` string, required: Customer phone number.
    - `email` string, required: Customer email address.
    - `dateOfBirth` string: Customer date of birth.
    - `createdAt` integer: The record created date and time as a UNIX timestamp.
    - `updatedAt` integer: The record created date and time as a UNIX timestamp.
    - `customerId` string: A unique Trustly customer identifier.
    - `externalId` string: A unique merchant customer identifier.
    - `merchantId` string: A unique Trustly merchant identifier.
    - `enrollDate` integer: Date of the user's first transaction in your system, regardless of payment method used as a UNIX timestamp.
    - `vip` string: Range that determines how low-risk the customer represents to the merchant
    - `currency` string: Customer currency.
    - `balance` string: Customer account balance (not associated with a financial institution account).
    - `organizationNumber` string: Organization number for business accounts
    - `externalTier` string: It should describe the customer''s rank to the merchant (e.g. Gold, Diamond, 4 stars, etc.)
    - `personId` string: Unique customer identity throughout different banks.
    - `customData` CustomerCustomData: Object for sending merchant-specific custom data.
    - `driverLicense` DriverLicense
      - `number` string, required: Driver License number.
      - `state` string, required: 2 character ISO State code.
    - `nationalId` string: Customer National ID

## Changes

- **2026-09-17** `dd0a38d95088`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2026-09-12** `1d5aabcc1d16`: 1 info
  - api operation id `post-customers-customerId` removed and replaced with `customers_post-customers-customerId`

[Operation history](https://skmtc.dev/trustly/apis/trustly-scalar-api/changes/customers/:customerId/post.md)

---

[API](https://skmtc.dev/trustly/apis/trustly-scalar-api.md) - [All operations](https://skmtc.dev/trustly/apis/trustly-scalar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trustly/apis/trustly-scalar-api/revisions/5c376a06c899?raw)