Quickstart: your first API call

In two minutes you create an organization API key and call the REST API with it.

Create an API key

In Brelio, open Configuración › Integraciones › Claves de API and click Nueva clave. Name it after the tool that will use it (for example «n8n»), tick Ver servicios and Ver profesionales, and create it.Copy the key now: Brelio shows it only once. Treat it like a password: keep it in a secret manager or an environment variable, never in code.

You need the Gestionar integraciones permission in Brelio, and your plan must include API access.

Save it in your shell

export BRELIO_API_KEY="paste-your-key-here"

List your services

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

The answer is a page of services:

Response

{
  "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
}

Read the limits it carries

Every answer carries the rate limit headers:

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

Response headers

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

The same call in your language

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")

If it fails

Answer	Why	Fix
`401 PLATFORM_UNAUTHENTICATED`	No `Authorization` header, or the key is wrong or revoked	Send `Authorization: Bearer <key>` with the full key.
`402 PLATFORM_PLAN_REQUIRED`	The clinic’s plan does not include API access	An owner adds it in Configuración › Suscripción.
`403 OPERATION_FORBIDDEN`	The key lacks the permission, named in `params.permission`	Create a key with that permission.
`403 DATA_AREA_OFF`	The clinic does not allow integrations to use that data area	See data areas.

Every code is explained in Errors.

Book an appointment

Find a free slot, book it, reschedule it and cancel it.

Authentication

Organization keys, personal keys, partner apps and MCP.

Get started

Concepts

Guides

MCP reference

Reference

Quickstart: your first API call

The same call in your language

If it fails

Next

Book an appointment

Authentication

​The same call in your language

​If it fails

​Next

Book an appointment

Authentication

The same call in your language

If it fails

Next