Skip to main content
POST
Crear o actualizar cliente

Authorizations

Authorization
string
header
required

Llave cbx_live creada para el partner.

Headers

Idempotency-Key
string
required

Identificador estable de la operación.

Minimum string length: 1
Cobrix-Timestamp
string
required

Segundos Unix dentro de una ventana de cinco minutos.

Pattern: ^[0-9]{10}$
Cobrix-Signature
string
required

HMAC-SHA256 de timestamp, método, ruta y cuerpo crudo.

Pattern: ^v1=[a-f0-9]{64}$
X-Request-Id
string

Identificador opcional para correlación de soporte.

Path Parameters

companyId
string<uuid>
required

Empresa vinculada a la llave.

Body

application/json
type
enum<string>
required
Available options:
individual,
business
name
string
required
Required string length: 1 - 200
source
string
required
Minimum string length: 1
externalCustomerId
string
required
Minimum string length: 1
email
string<email> | null
phone
string | null
taxId
string | null
customerCode
string | null
metadata
object

Response

Cliente procesado

customerId
string<uuid>
required
companyCustomerId
string<uuid>
required
source
string
required
externalCustomerId
string
required
status
enum<string>
required
Available options:
created,
updated,
unchanged,
rejected