Ir al contenido
KUTI

Editar cliente

Edita nombre, razón social, correo o teléfono. Solo los campos enviados se modifican.

PATCHhttps://api.kuti.pe/v1/customers/{id}
El tipo (INDIVIDUAL/COMPANY), el documento y el external_id no se pueden cambiar. Enviar "" borra el valor. En custom_fields solo cambian las keys enviadas (null borra).

Parámetros del body

Campo
Descripción
id
stringrequerido
Id del customer en el path.Ej: cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3
first_name
stringopcional
Nombres.Ej: María
last_name
stringopcional
Apellidos.Ej: López Torres
company_name
stringopcional
Razón social (COMPANY).
email
stringopcional
Correo. Si lo cambias a uno que ya tiene otro cliente, responde 409 CUSTOMER_ALREADY_EXISTS.Ej: maria.lopez@example.com
phone
stringopcional
Teléfono. Un celular peruano se guarda siempre como +51 y sus 9 dígitos, lo envíes como lo envíes (999111222, 51999111222 o +51 999 111 222 quedan como +51999111222). Si lo cambias a uno que ya tiene otro cliente, responde 409 CUSTOMER_ALREADY_EXISTS.Ej: +51987654321
metadata
objectopcional
Si viene, reemplaza la metadata completa.
custom_fields
objectopcional
Campos personalizados que definiste en Ajustes → Clientes → Campos (ver Campos de cliente). Objeto { key: valor }: texto, número como texto ("12.5"), fecha "YYYY-MM-DD", hora "HH:mm", true/false, key de opción (SELECT; también acepta la etiqueta) o lista de keys (MULTISELECT). Solo cambian las keys enviadas; null borra ese valor. Una key desconocida o un valor inválido devuelve 422 con el detalle custom_fields.<key>.Ej: {"grade": "quinto", "student_code": "2026-00781"}

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con SDK oficial

API Request
$ npm install @kuti-pe/node
import { KutiClient } from "@kuti-pe/node";

const kuti = new KutiClient({ secretKey: process.env.KUTI_SECRET_KEY! });

const result = await kuti.customers.update("cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3", { email: "ana.rojas@example.pe" });
console.log(result.email);
SDK oficial · guía en /sdks
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "message": "Customer updated",
  "data": {
    "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "external_id": "cust_erp_4821",
    "type": "INDIVIDUAL",
    "first_name": "María",
    "last_name": "López Torres",
    "document": {
      "type": "DNI",
      "number": "45678912",
      "country": "PE"
    },
    "email": "maria.lopez@example.com",
    "phone": "+51987654321",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}