Crear una cita
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.koibox.cloud/api/agenda/"), Headers = { { "X-Koibox-Key", "<X-Koibox-Key>" }, }, Content = new StringContent("{ \"notas\": \"example\", \"duracion\": \"example\", \"titulo\": \"example\", \"observaciones\": \"example\", \"is_empleado_aleatorio\": true, \"fecha\": \"2026-04-15\", \"hora_inicio\": \"example\", \"hora_fin\": \"example\", \"is_cliente_en_centro\": true, \"user\": { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" }, \"cliente\": { \"text\": \"example\", \"value\": 1, \"email\": \"hello@example.com\", \"movil\": \"example\", \"notas\": \"example\", \"foto_url_absolute_path\": \"https://example.com\", \"localidad\": \"example\", \"importe_ventas\": 1, \"importe_deudas\": 1, \"code\": 1, \"manual_code\": \"example\", \"fijo\": \"example\", \"dni\": \"example\", \"prefijo_tel\": 1 }, \"estado\": { \"id\": 1, \"value\": 1, \"nombre\": \"example\", \"text\": \"example\" }, \"servicios\": [ { \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": \"example\", \"is_tarifas\": true, \"precio_tarifa1\": \"example\", \"precio_tarifa2\": \"example\", \"precio_tarifa3\": \"example\", \"precio_tarifa4\": \"example\", \"duracion\": \"example\", \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"is_active\": true, \"users\": [ { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" } ], \"is_disponible_online\": true, \"descuento_online\": 1, \"secure_payment_amount\": \"example\", \"productos_escandallo\": [ { \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"proveedor\": {}, \"servicios_escandallo\": [], \"stock\": { \"existencias\": 1, \"stock_minimo\": 1 }, \"barcode\": \"example\", \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": 1, \"precio_online\": 1, \"precio_coste\": 1, \"pedido_minimo\": 1, \"is_active\": true, \"is_uso_interno\": false, \"is_disponible_ecommerce\": true, \"imagenes\": [ { \"name\": \"example\", \"size\": 1, \"type\": \"example\", \"opts\": { \"principal\": true } } ], \"impuesto\": 1 } ], \"impuesto\": 1, \"orden\": 1, \"tbai_vat_exemption_cause\": 1 } ], \"servicios_combinados\": [ 1 ], \"tags\": [ { \"id\": 1, \"name\": \"example\" } ] }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.koibox.cloud/api/agenda/")) .header("X-Koibox-Key", "<X-Koibox-Key>") .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString("{ \"notas\": \"example\", \"duracion\": \"example\", \"titulo\": \"example\", \"observaciones\": \"example\", \"is_empleado_aleatorio\": true, \"fecha\": \"2026-04-15\", \"hora_inicio\": \"example\", \"hora_fin\": \"example\", \"is_cliente_en_centro\": true, \"user\": { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" }, \"cliente\": { \"text\": \"example\", \"value\": 1, \"email\": \"hello@example.com\", \"movil\": \"example\", \"notas\": \"example\", \"foto_url_absolute_path\": \"https://example.com\", \"localidad\": \"example\", \"importe_ventas\": 1, \"importe_deudas\": 1, \"code\": 1, \"manual_code\": \"example\", \"fijo\": \"example\", \"dni\": \"example\", \"prefijo_tel\": 1 }, \"estado\": { \"id\": 1, \"value\": 1, \"nombre\": \"example\", \"text\": \"example\" }, \"servicios\": [ { \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": \"example\", \"is_tarifas\": true, \"precio_tarifa1\": \"example\", \"precio_tarifa2\": \"example\", \"precio_tarifa3\": \"example\", \"precio_tarifa4\": \"example\", \"duracion\": \"example\", \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"is_active\": true, \"users\": [ { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" } ], \"is_disponible_online\": true, \"descuento_online\": 1, \"secure_payment_amount\": \"example\", \"productos_escandallo\": [ { \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"proveedor\": {}, \"servicios_escandallo\": [], \"stock\": { \"existencias\": 1, \"stock_minimo\": 1 }, \"barcode\": \"example\", \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": 1, \"precio_online\": 1, \"precio_coste\": 1, \"pedido_minimo\": 1, \"is_active\": true, \"is_uso_interno\": false, \"is_disponible_ecommerce\": true, \"imagenes\": [ { \"name\": \"example\", \"size\": 1, \"type\": \"example\", \"opts\": { \"principal\": true } } ], \"impuesto\": 1 } ], \"impuesto\": 1, \"orden\": 1, \"tbai_vat_exemption_cause\": 1 } ], \"servicios_combinados\": [ 1 ], \"tags\": [ { \"id\": 1, \"name\": \"example\" } ] }")) .build();HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());System.out.println(response.body());OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{ \"notas\": \"example\", \"duracion\": \"example\", \"titulo\": \"example\", \"observaciones\": \"example\", \"is_empleado_aleatorio\": true, \"fecha\": \"2026-04-15\", \"hora_inicio\": \"example\", \"hora_fin\": \"example\", \"is_cliente_en_centro\": true, \"user\": { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" }, \"cliente\": { \"text\": \"example\", \"value\": 1, \"email\": \"hello@example.com\", \"movil\": \"example\", \"notas\": \"example\", \"foto_url_absolute_path\": \"https://example.com\", \"localidad\": \"example\", \"importe_ventas\": 1, \"importe_deudas\": 1, \"code\": 1, \"manual_code\": \"example\", \"fijo\": \"example\", \"dni\": \"example\", \"prefijo_tel\": 1 }, \"estado\": { \"id\": 1, \"value\": 1, \"nombre\": \"example\", \"text\": \"example\" }, \"servicios\": [ { \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": \"example\", \"is_tarifas\": true, \"precio_tarifa1\": \"example\", \"precio_tarifa2\": \"example\", \"precio_tarifa3\": \"example\", \"precio_tarifa4\": \"example\", \"duracion\": \"example\", \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"is_active\": true, \"users\": [ { \"value\": 1, \"text\": \"example\", \"color\": \"example\", \"username\": \"hello@example.com\", \"foto_url_absolute_path\": \"https://example.com\" } ], \"is_disponible_online\": true, \"descuento_online\": 1, \"secure_payment_amount\": \"example\", \"productos_escandallo\": [ { \"categoria\": { \"value\": 1, \"text\": \"example\", \"nombre\": \"example\", \"id\": 1, \"orden\": 1, \"is_active\": true }, \"proveedor\": {}, \"servicios_escandallo\": [], \"stock\": { \"existencias\": 1, \"stock_minimo\": 1 }, \"barcode\": \"example\", \"referencia\": \"example\", \"nombre\": \"example\", \"detalle\": \"example\", \"precio\": 1, \"precio_online\": 1, \"precio_coste\": 1, \"pedido_minimo\": 1, \"is_active\": true, \"is_uso_interno\": false, \"is_disponible_ecommerce\": true, \"imagenes\": [ { \"name\": \"example\", \"size\": 1, \"type\": \"example\", \"opts\": { \"principal\": true } } ], \"impuesto\": 1 } ], \"impuesto\": 1, \"orden\": 1, \"tbai_vat_exemption_cause\": 1 } ], \"servicios_combinados\": [ 1 ], \"tags\": [ { \"id\": 1, \"name\": \"example\" } ] }");Request request = new Request.Builder() .url("https://api.koibox.cloud/api/agenda/") .post(body) .addHeader("X-Koibox-Key", "<X-Koibox-Key>") .addHeader("Content-Type", "application/json") .build();
Response response = client.newCall(request).execute();import axios from 'axios';
const options = { method: 'POST', url: 'https://api.koibox.cloud/api/agenda/', headers: {'X-Koibox-Key': '<X-Koibox-Key>', 'Content-Type': 'application/json'}, data: { notas: 'example', duracion: 'example', titulo: 'example', observaciones: 'example', is_empleado_aleatorio: true, fecha: '2026-04-15', hora_inicio: 'example', hora_fin: 'example', is_cliente_en_centro: true, user: { value: 1, text: 'example', color: 'example', username: 'hello@example.com', foto_url_absolute_path: 'https://example.com' }, cliente: { text: 'example', value: 1, email: 'hello@example.com', movil: 'example', notas: 'example', foto_url_absolute_path: 'https://example.com', localidad: 'example', importe_ventas: 1, importe_deudas: 1, code: 1, manual_code: 'example', fijo: 'example', dni: 'example', prefijo_tel: 1 }, estado: {id: 1, value: 1, nombre: 'example', text: 'example'}, servicios: [ { referencia: 'example', nombre: 'example', detalle: 'example', precio: 'example', is_tarifas: true, precio_tarifa1: 'example', precio_tarifa2: 'example', precio_tarifa3: 'example', precio_tarifa4: 'example', duracion: 'example', categoria: {value: 1, text: 'example', nombre: 'example', id: 1, orden: 1, is_active: true}, is_active: true, users: [ { value: 1, text: 'example', color: 'example', username: 'hello@example.com', foto_url_absolute_path: 'https://example.com' } ], is_disponible_online: true, descuento_online: 1, secure_payment_amount: 'example', productos_escandallo: [ { categoria: {value: 1, text: 'example', nombre: 'example', id: 1, orden: 1, is_active: true}, proveedor: {}, servicios_escandallo: [], stock: {existencias: 1, stock_minimo: 1}, barcode: 'example', referencia: 'example', nombre: 'example', detalle: 'example', precio: 1, precio_online: 1, precio_coste: 1, pedido_minimo: 1, is_active: true, is_uso_interno: false, is_disponible_ecommerce: true, imagenes: [{name: 'example', size: 1, type: 'example', opts: {principal: true}}], impuesto: 1 } ], impuesto: 1, orden: 1, tbai_vat_exemption_cause: 1 } ], servicios_combinados: [1], tags: [{id: 1, name: 'example'}] }};
try { const { data } = await axios.request(options); console.log(data);} catch (error) { console.error(error);}const url = 'https://api.koibox.cloud/api/agenda/';const options = { method: 'POST', headers: {'X-Koibox-Key': '<X-Koibox-Key>', 'Content-Type': 'application/json'}, body: '{"notas":"example","duracion":"example","titulo":"example","observaciones":"example","is_empleado_aleatorio":true,"fecha":"2026-04-15","hora_inicio":"example","hora_fin":"example","is_cliente_en_centro":true,"user":{"value":1,"text":"example","color":"example","username":"hello@example.com","foto_url_absolute_path":"https://example.com"},"cliente":{"text":"example","value":1,"email":"hello@example.com","movil":"example","notas":"example","foto_url_absolute_path":"https://example.com","localidad":"example","importe_ventas":1,"importe_deudas":1,"code":1,"manual_code":"example","fijo":"example","dni":"example","prefijo_tel":1},"estado":{"id":1,"value":1,"nombre":"example","text":"example"},"servicios":[{"referencia":"example","nombre":"example","detalle":"example","precio":"example","is_tarifas":true,"precio_tarifa1":"example","precio_tarifa2":"example","precio_tarifa3":"example","precio_tarifa4":"example","duracion":"example","categoria":{"value":1,"text":"example","nombre":"example","id":1,"orden":1,"is_active":true},"is_active":true,"users":[{"value":1,"text":"example","color":"example","username":"hello@example.com","foto_url_absolute_path":"https://example.com"}],"is_disponible_online":true,"descuento_online":1,"secure_payment_amount":"example","productos_escandallo":[{"categoria":{"value":1,"text":"example","nombre":"example","id":1,"orden":1,"is_active":true},"proveedor":{},"servicios_escandallo":[],"stock":{"existencias":1,"stock_minimo":1},"barcode":"example","referencia":"example","nombre":"example","detalle":"example","precio":1,"precio_online":1,"precio_coste":1,"pedido_minimo":1,"is_active":true,"is_uso_interno":false,"is_disponible_ecommerce":true,"imagenes":[{"name":"example","size":1,"type":"example","opts":{"principal":true}}],"impuesto":1}],"impuesto":1,"orden":1,"tbai_vat_exemption_cause":1}],"servicios_combinados":[1],"tags":[{"id":1,"name":"example"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.koibox.cloud/api/agenda/ \ --header 'Content-Type: application/json' \ --header 'X-Koibox-Key: <X-Koibox-Key>' \ --data '{ "notas": "example", "duracion": "example", "titulo": "example", "observaciones": "example", "is_empleado_aleatorio": true, "fecha": "2026-04-15", "hora_inicio": "example", "hora_fin": "example", "is_cliente_en_centro": true, "user": { "value": 1, "text": "example", "color": "example", "username": "hello@example.com", "foto_url_absolute_path": "https://example.com" }, "cliente": { "text": "example", "value": 1, "email": "hello@example.com", "movil": "example", "notas": "example", "foto_url_absolute_path": "https://example.com", "localidad": "example", "importe_ventas": 1, "importe_deudas": 1, "code": 1, "manual_code": "example", "fijo": "example", "dni": "example", "prefijo_tel": 1 }, "estado": { "id": 1, "value": 1, "nombre": "example", "text": "example" }, "servicios": [ { "referencia": "example", "nombre": "example", "detalle": "example", "precio": "example", "is_tarifas": true, "precio_tarifa1": "example", "precio_tarifa2": "example", "precio_tarifa3": "example", "precio_tarifa4": "example", "duracion": "example", "categoria": { "value": 1, "text": "example", "nombre": "example", "id": 1, "orden": 1, "is_active": true }, "is_active": true, "users": [ { "value": 1, "text": "example", "color": "example", "username": "hello@example.com", "foto_url_absolute_path": "https://example.com" } ], "is_disponible_online": true, "descuento_online": 1, "secure_payment_amount": "example", "productos_escandallo": [ { "categoria": { "value": 1, "text": "example", "nombre": "example", "id": 1, "orden": 1, "is_active": true }, "proveedor": {}, "servicios_escandallo": [], "stock": { "existencias": 1, "stock_minimo": 1 }, "barcode": "example", "referencia": "example", "nombre": "example", "detalle": "example", "precio": 1, "precio_online": 1, "precio_coste": 1, "pedido_minimo": 1, "is_active": true, "is_uso_interno": false, "is_disponible_ecommerce": true, "imagenes": [ { "name": "example", "size": 1, "type": "example", "opts": { "principal": true } } ], "impuesto": 1 } ], "impuesto": 1, "orden": 1, "tbai_vat_exemption_cause": 1 } ], "servicios_combinados": [ 1 ], "tags": [ { "id": 1, "name": "example" } ] }'Authorizations
Sección titulada «Authorizations»Request Body
Sección titulada «Request Body»object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Fecha de la cita, se espera en zona horaria del centro
Obligatorio en citas con servicios normales y sin servicios combinados. No incluir en citas con servicios combinados.
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo lectura
object
Nombre del cliente
Identificador del cliente
Número de móvil del cliente
Solo escritura
Cita padre a la actual, solo lectura
Solo escritura
Solo lectura
Solo lectura
object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo escritura
Solo lectura
object
Solo lectura
object
object
Nombre del archivo
Tamaño del archivo (en bytes)
Tipo MIME del archivo
object
Indica si es la imagen principal del producto
Solo escritura
Solo lectura
object
Ids de los servicios combinados de la cita, solo escritura. Incluir servicios combinados en la cita la dividirá por servicios automáticamente.
Tiempo ajustado a la zona horaria del centro, solo lectura
Venta creada desde la cita, solo lectura
Firma HMAC de la cita usada para poder enviar al usuario al flujo de pago online, solo lectura
Responses
Sección titulada «Responses»La cita creada. Si se incluyen servicios combinados se divide por servicios automáticamente por lo que se devuelve un array con cada cita creada.
object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Fecha de la cita, se espera en zona horaria del centro
Obligatorio en citas con servicios normales y sin servicios combinados. No incluir en citas con servicios combinados.
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo lectura
object
Nombre del cliente
Identificador del cliente
Número de móvil del cliente
Solo escritura
Cita padre a la actual, solo lectura
Solo escritura
Solo lectura
Solo lectura
object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo escritura
Solo lectura
object
Solo lectura
object
object
Nombre del archivo
Tamaño del archivo (en bytes)
Tipo MIME del archivo
object
Indica si es la imagen principal del producto
Solo escritura
Solo lectura
object
Ids de los servicios combinados de la cita, solo escritura. Incluir servicios combinados en la cita la dividirá por servicios automáticamente.
Tiempo ajustado a la zona horaria del centro, solo lectura
Venta creada desde la cita, solo lectura
Firma HMAC de la cita usada para poder enviar al usuario al flujo de pago online, solo lectura
object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Fecha de la cita, se espera en zona horaria del centro
Obligatorio en citas con servicios normales y sin servicios combinados. No incluir en citas con servicios combinados.
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo lectura
object
Nombre del cliente
Identificador del cliente
Número de móvil del cliente
Solo escritura
Cita padre a la actual, solo lectura
Solo escritura
Solo lectura
Solo lectura
object
Solo lectura
Solo lectura
Solo lectura
Solo lectura
object
Identificador del usuario
Nombre del usuario
Solo escritura
Solo lectura
object
Solo lectura
object
object
Nombre del archivo
Tamaño del archivo (en bytes)
Tipo MIME del archivo
object
Indica si es la imagen principal del producto
Solo escritura
Solo lectura
object
Ids de los servicios combinados de la cita, solo escritura. Incluir servicios combinados en la cita la dividirá por servicios automáticamente.
Tiempo ajustado a la zona horaria del centro, solo lectura
Venta creada desde la cita, solo lectura
Firma HMAC de la cita usada para poder enviar al usuario al flujo de pago online, solo lectura
La petición está mal formada, faltan campos requeridos.
No se ha proporcionado la clave de acceso en la header X-Koibox-Key
Headers
Sección titulada «Headers»Indica la cabecera requerida para la autenticación
No se ha proporcionado una clave de acceso válida
