---
title: "Overwrite customer"
method: PUT
path: "/accounts/v2/customers/{customerId}"
tags: ["Customers"]
---

# Overwrite customer

`PUT /accounts/v2/customers/{customerId}`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/accounts/v2/customers/{customerId}`
- Auth: HTTP bearer

Overwrite some customer information. This endpoint allows you to mark the customer on the account as active or inactive using the `is_active` field. This field is informative only. There are no restrictions that prevent inactive customers from performing any actions.

If `customer.is_active` = `true`, and the `Maximum number of card holders` program parameter is set, this customer is counted in the account's maximum number of card holders limit.

If the `customerId` parameter is not set, the server returns "Cannot get property `customerId` on null object".

**Note:** If `social_name` and `nickname` are not passed, their values are overwritten as null.

This endpoint generates a [Customer changed](https://developers.pismo.io/events/docs/account-customer-change-2) event.

## Path parameters

- `customerId` integer, required

## Request body

- OverwriteCustomerInformationRequest: Overwrite customer information request body
  - `customer` object
    - `printed_name` string: This field is **DEPRECATED**. Name to be printed on the card. Punctuation, special characters, and connectors (da/das/de/do/dos/e) are always removed. This field's maximum length is 25, but you can set it to a lower value at the program level with the `Max name length on physical card` program parameter. If `printed_name` is null, the Pismo platform uses `social_name`. If `social_name` is null, the Pismo platform uses the customer's entity name. For more information on the customer object, refer to [Core objects](doc:setup-overview#customer). The Pismo platform gets the name for program parameter `TAMANHO MAX NOME EMBOSSADO` (max size name embossed).
    - `social_name` string: Social name.
    - `nickname` string: Nickname.
    - `is_active` boolean: Is customer active or not active? If `is_active` is null in this request, the Pismo platform doesn't overwrite the existing value.
    - `email` string, email: Email address.

## Response `200`

OK

## Other responses

- `400`: Bad request
- `404`: Customer {customerId} not found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/core-platform-accounts.md) - [All operations](https://skmtc.dev/pismo/apis/core-platform-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/core-platform-accounts/revisions/0b24a835073b?raw)