Skip to content

Save client

POST
/api/clientes/
curl --request POST \
--url https://api.koibox.cloud/api/clientes/ \
--header 'Content-Type: application/json' \
--header 'X-Koibox-Key: <X-Koibox-Key>' \
--data '{ "nombre": "example", "apellido1": "example", "apellido2": "example", "dni": "example", "movil": "example", "fijo": "example", "email": "hello@example.com", "direccion": "example", "localidad": "example", "codigo_postal": "example", "fecha_nacimiento": "2026-04-15", "is_suscrito_newsletter": true, "is_suscrito_encuestas": true, "is_active": true, "is_agree_notificaciones_sms": true, "is_agree_notificaciones_email": true, "sexo": "h", "notas": "example", "foto": "https://example.com", "descuento_ventas": 1, "is_citas_online": true, "code": 1, "manual_code": "example", "is_envios_sms": false, "is_envios_email": false, "prefijo_tel": "example", "provincia": { "id": 1, "value": 1, "text": "example" }, "created_by": { "value": 1, "text": "example", "color": "example", "username": "hello@example.com", "foto_url_absolute_path": "https://example.com" }, "categoria": { "value": 1, "text": "example", "nombre": "example", "id": 1, "orden": 1, "is_active": true }, "como_nos_conocio": { "value": 1, "text": "example" }, "informacion_clinica": "example" }'
Media typeapplication/json
object
id

Read-only

integer
created

Read-only

string format: date-time
updated

Read-only

string format: date-time
nombre
required
string
apellido1
string
apellido2
One of:
string
dni
One of:
string
movil
One of:
string
fijo
One of:
string
email
One of:
string format: email
direccion
One of:
string
localidad
One of:
string
codigo_postal
One of:
string
fecha_nacimiento
One of:
string format: date
is_suscrito_newsletter
boolean
default: true
is_suscrito_encuestas
boolean
default: true
is_active
boolean
default: true
is_sms_cliente_perdido_enviado

Read-only

boolean
is_email_cliente_perdido_enviado

Read-only

boolean
is_agree_notificaciones_sms
boolean
default: true
is_agree_notificaciones_email
boolean
default: true
sexo
One of:
string
Allowed values: h m
notas
One of:
string
foto
One of:

Read-only

string format: uri
origen

Read-only

string
descuento_ventas
number
is_citas_online
boolean
default: true
code

Por defecto es un campo autoincremental, pero se puede sobreescribir siempre que no haya conflicto

integer
manual_code
One of:
string
is_agree_rgpd

Read-only

boolean
b64_firma_rgpd

Read-only

string format: base64
fecha_firma_rgpd

Read-only

string format: date
file_contrato_rgpd

Read-only

string format: uri
is_anonymous

Read-only

boolean
is_envios_sms

This field is required if you want to send SMS to the client

boolean
is_envios_email

This field is required if you want to send emails to the client

boolean
prefijo_tel
One of:
string
fecha_ultima_venta

Read-only

string format: date
numero_ventas

Read-only

integer
importe_ventas

Read-only

number
importe_deudas

Read-only

number
fecha_ultima_cita_realizada

Read-only

string format: date
total_citas_realizadas

Read-only

integer
fecha_alta

Read-only

string format: date-time
provincia
One of:

Read-only

object
id

Identifier of the province

integer
value

Identifier of the province

integer
text

Name of the province

string
created_by
One of:

Read-only

object
value

Identifier of the user

integer
text

Name of the user

string
color
string format: hex
username
string format: email
foto_url_absolute_path
string format: uri
categoria
One of:

Read-only

object
value
integer
text
string
nombre
string
id
integer
orden
One of:
integer
is_active
boolean
como_nos_conocio
One of:

Read-only

object
value
integer
text
string
informacion_clinica
One of:
string
puntos_disponibles

Read-only

integer

The created client

Media typeapplication/json
object
id

Read-only

integer
created

Read-only

string format: date-time
updated

Read-only

string format: date-time
nombre
required
string
apellido1
string
apellido2
One of:
string
dni
One of:
string
movil
One of:
string
fijo
One of:
string
email
One of:
string format: email
direccion
One of:
string
localidad
One of:
string
codigo_postal
One of:
string
fecha_nacimiento
One of:
string format: date
is_suscrito_newsletter
boolean
default: true
is_suscrito_encuestas
boolean
default: true
is_active
boolean
default: true
is_sms_cliente_perdido_enviado

Read-only

boolean
is_email_cliente_perdido_enviado

Read-only

boolean
is_agree_notificaciones_sms
boolean
default: true
is_agree_notificaciones_email
boolean
default: true
sexo
One of:
string
Allowed values: h m
notas
One of:
string
foto
One of:

Read-only

string format: uri
origen

Read-only

string
descuento_ventas
number
is_citas_online
boolean
default: true
code

Por defecto es un campo autoincremental, pero se puede sobreescribir siempre que no haya conflicto

integer
manual_code
One of:
string
is_agree_rgpd

Read-only

boolean
b64_firma_rgpd

Read-only

string format: base64
fecha_firma_rgpd

Read-only

string format: date
file_contrato_rgpd

Read-only

string format: uri
is_anonymous

Read-only

boolean
is_envios_sms

This field is required if you want to send SMS to the client

boolean
is_envios_email

This field is required if you want to send emails to the client

boolean
prefijo_tel
One of:
string
fecha_ultima_venta

Read-only

string format: date
numero_ventas

Read-only

integer
importe_ventas

Read-only

number
importe_deudas

Read-only

number
fecha_ultima_cita_realizada

Read-only

string format: date
total_citas_realizadas

Read-only

integer
fecha_alta

Read-only

string format: date-time
provincia
One of:

Read-only

object
id

Identifier of the province

integer
value

Identifier of the province

integer
text

Name of the province

string
created_by
One of:

Read-only

object
value

Identifier of the user

integer
text

Name of the user

string
color
string format: hex
username
string format: email
foto_url_absolute_path
string format: uri
categoria
One of:

Read-only

object
value
integer
text
string
nombre
string
id
integer
orden
One of:
integer
is_active
boolean
como_nos_conocio
One of:

Read-only

object
value
integer
text
string
informacion_clinica
One of:
string
puntos_disponibles

Read-only

integer

The request is malformed, required fields are missing.

The access key has not been provided in the X-Koibox-Key header

WWW-Authenticate
string
default: X-Koibox-Key

Indicates the required header for authentication

No valid access key has been provided