TRtrytoku
Customers

Crear Customer

Changed on

Crea un Customer o actualiza el existente si coincide el external_id.

Es idempotente por external_id dentro de la organización: si ya existe un Customer con ese identificador externo, se actualizan sus datos y la respuesta es 200; si es nuevo, se crea y la respuesta es 201. Los campos no enviados se dejan sin cambios.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

post/customers

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/customers
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

x-api-versionstring date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

Example:2026-10-08

Request body

admin_areastring
admin_codestring
agent_phone_numberstring
citystring
default_agentstring
default_receipt_type'bill' | 'invoice' | 'no_receipt'

Documento tributario que se emite al cobrar: bill es una boleta, invoice una factura y no_receipt deja el cobro sin documento asociado.

detailstring
external_idstring

Identificador externo del Customer definido por la organización. Se usa como clave de idempotencia al crear o actualizar.

fiscal_regimestring
government_idstring

Identificador tributario o personal del Customer según su país (por ejemplo, el RUT en Chile).

mailstring

Correo electrónico del Customer.

metadataobject
namestring

Nombre del Customer.

neighborhoodstring
pac_mandate_idstring
phone_numberstring

Número de teléfono del Customer.

postal_codestring
rfcstring
secondary_emailsstring[]
send_mailboolean
silenced_untilstring date-time
street_namestring
street_numberstring
tax_zip_codestring

Example request

{
  "external_id": "18579878K",
  "government_id": "18579878K",
  "mail": "jon@snow.got",
  "name": "Jon Snow",
  "phone_number": "+56987654321"
}

Response

Successful Response

agent_phone_numberstring

Número de teléfono del agente por defecto.

default_agentstring

Correo del agente por defecto que contactará al cliente cuando se abra un ticket.

default_receipt_type'bill' | 'invoice' | 'no_receipt'

Documento tributario que se emite al cobrar: bill es una boleta, invoice una factura y no_receipt deja el cobro sin documento asociado.

external_idstring

Identificador externo del cliente definido por la organización. Por defecto, las organizaciones usan el government_id como identificador externo del cliente.

fiscal_regimestring

Régimen fiscal del cliente, requerido para generar el recibo CFDI (México).

government_idstring

Identificador tributario o personal del cliente según su país. Por ejemplo, el RUT de una persona en Chile: 18.579.787-K.

idstring required

Identificador público del cliente.

mailstring

Correo electrónico del cliente.

metadataobject

Campos adicionales definidos por cada organización para el cliente.

namestring

Nombre del cliente.

pac_mandate_idstring

Identificador del mandato PAC (Pago Automático de Cuentas) asociado al cliente.

phone_numberstring

Número de teléfono del cliente.

rfcstring

RFC del cliente (México); si está presente, la deuda generará el documento tributario correspondiente.

secondary_emailsstring[]

Lista de correos electrónicos secundarios del cliente.

send_mailboolean

Determina si se debe emitir el webhook 'invoice.no_payment_method' al crear el cliente.

silenced_untilstring date-time

Fecha y hora en que expira el silenciamiento del cliente. Si es null, el cliente no está silenciado.

tax_zip_codestring

Código postal tributario del cliente, requerido para generar el recibo CFDI (México).

Example response

{
  "agent_phone_number": "+56990220640",
  "default_agent": "arya@stark.com",
  "external_id": "18579878K",
  "fiscal_regime": "601",
  "government_id": "18579878K",
  "id": "cus_ejC08yLqOWoFhVx4Fx42E3IR9X50tNx2",
  "mail": "jon@snow.got",
  "metadata": {
    "car_brand": "Toyota",
    "car_model": "Yaris"
  },
  "name": "Jon Snow",
  "pac_mandate_id": "18547404k",
  "phone_number": "+56987654321",
  "rfc": "EKU9003173C9",
  "secondary_emails": [
    "shiryu@dragon.cdz",
    "seiya@pegasus.cdz"
  ],
  "tax_zip_code": "78187"
}

Changes