customers

Crear un cliente

Crea un nuevo cliente. Si ya existe un usuario con el email proporcionado, el cliente se asocia a ese usuario. Si el email es nuevo, se crean tanto el usuario como el cliente.

post/customers

Headers

X-SECRET-KEYstring required

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Request body

emailstring email required

Email del cliente (se usa para buscar o crear el usuario)

full_namestring

Nombre completo

namestring

Nombre para mostrar

phonestring

(Opcional) Número de teléfono

addressstring

(Opcional) Dirección

nitstring

(Opcional) Número de identificación tributaria

metadataobject

(Opcional) Metadata personalizada

test_clock_idstring

ID de un Test Clock del mismo Sandbox. No está disponible en LIVE.

Response

Cliente creado o encontrado

idstring

ID único del cliente

user_idstring

ID del usuario asociado

emailstring email

Email del cliente

namestring

Nombre del cliente

phonestring nullable

Número de teléfono

addressstring nullable

Dirección

nitstring nullable

Número de identificación tributaria

metadataobject nullable

Metadata personalizada

test_clock_idstring nullable

ID del test clock asignado al Customer. Solo puede usarse con una llave de un Sandbox nombrado.

Changes

No recorded changes to this endpoint across all 1 revision of this API.