HomeGuíasAPI ReferenceChangelog
Log In
API Reference
  1. Recursos principales
  2. Customers

Crear Customer

post
https://api.trytoku.com/customers

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Campos del cuerpo para crear o actualizar un Customer.

string
string
string
length ≤ 16
string
string
length ≤ 128
string
enum
Defaults to bill

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

Allowed:
string
string
length ≤ 128

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

string
length ≤ 4
string
length ≤ 64

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

string
length ≤ 128

Correo electrónico del Customer.

metadata
object
string
length ≤ 128

Nombre del Customer.

string
string
length ≤ 64
string
length ≤ 16

Número de teléfono del Customer.

string
string
length ≤ 16
secondary_emails
array of strings
Secondary Emails
boolean
Defaults to false
date-time
string
string
string
length ≤ 8
Headers
string

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

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.

Responses

Updated 5 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago

Did this page help you?