Inicio rápido: tu primera llamada a la API

En dos minutos creas una clave de API de la organización y llamas a la API REST con ella.

Crea una clave de API

En Brelio, abre Configuración › Integraciones › Claves de API y pulsa Nueva clave. Ponle el nombre de la herramienta que la usará (por ejemplo «n8n»), marca Ver servicios y Ver profesionales, y créala.Copia la clave ahora: Brelio solo la muestra una vez. Trátala como una contraseña: guárdala en un gestor de secretos o en una variable de entorno, nunca en el código.

Necesitas el permiso Gestionar integraciones en Brelio, y tu plan debe incluir el acceso a la API.

Guárdala en tu terminal

export BRELIO_API_KEY="pega-aquí-tu-clave"

Lista tus servicios

curl https://api.brelio.app/v1/services \
  -H "Authorization: Bearer $BRELIO_API_KEY"

La respuesta es una página de servicios:

Respuesta

{
  "data": [
    {
      "id": "c3c8e275-a6b1-4fba-9b17-9c0a01e3ffc8",
      "name": "Fisioterapia",
      "description": null,
      "status": "active",
      "defaultDuration": 45,
      "color": null,
      "price": null,
      "createdAt": "2026-11-09T17:59:08.454Z",
      "updatedAt": "2026-11-09T17:59:08.454Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Mira los límites que lleva

Cada respuesta lleva las cabeceras de límites de uso:

curl -sS -D - -o /dev/null https://api.brelio.app/v1/services \
  -H "Authorization: Bearer $BRELIO_API_KEY"

Cabeceras de la respuesta

HTTP/2 200
ratelimit-policy: "burst";q=100;w=10, "standard";q=600;w=60
ratelimit: "standard";r=599;t=52
x-request-id: 64461250-2749-41ee-9ce9-1e01c2529401

La misma llamada en tu lenguaje

curl https://api.brelio.app/v1/services?status=active \
  -H "Authorization: Bearer $BRELIO_API_KEY"

const response = await fetch('https://api.brelio.app/v1/services?status=active', {
  headers: { Authorization: `Bearer ${process.env.BRELIO_API_KEY}` },
})
if (!response.ok) throw new Error(JSON.stringify(await response.json()))
const { data } = await response.json()
for (const service of data) console.log(service.name, service.defaultDuration, 'min')

import os
import requests

response = requests.get(
    "https://api.brelio.app/v1/services",
    params={"status": "active"},
    headers={"Authorization": f"Bearer {os.environ['BRELIO_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
for service in response.json()["data"]:
    print(service["name"], service["defaultDuration"], "min")

Si falla

Respuesta	Por qué	Solución
`401 PLATFORM_UNAUTHENTICATED`	Falta la cabecera `Authorization`, o la clave es incorrecta o está revocada	Envía `Authorization: Bearer <clave>` con la clave completa.
`402 PLATFORM_PLAN_REQUIRED`	El plan de la clínica no incluye el acceso a la API	Un propietario lo añade en Configuración › Suscripción.
`403 OPERATION_FORBIDDEN`	A la clave le falta el permiso que indica `params.permission`	Crea una clave con ese permiso.
`403 DATA_AREA_OFF`	La clínica no deja que las integraciones usen esa área de datos	Consulta las áreas de datos.

Todos los códigos están explicados en Errores.

Siguiente paso

Reserva una cita

Busca un hueco libre, resérvalo, reprográmalo y cancélalo.

Autenticación

Claves de la organización, claves personales, apps de partners y MCP.

Empezar

Conceptos

Guías

Referencia MCP

Referencia

Inicio rápido: tu primera llamada a la API

La misma llamada en tu lenguaje

Si falla

Siguiente paso

Reserva una cita

Autenticación

​La misma llamada en tu lenguaje

​Si falla

​Siguiente paso

Reserva una cita

Autenticación

La misma llamada en tu lenguaje

Si falla

Siguiente paso