> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Magicline Connect API

> Tu asistente reserva sesiones de prueba sin clave API de Magicline.

Tu asistente reserva sesiones de prueba sin clave API de Magicline.

## Conectar un estudio

1. Abre **Agent Tools → Marketplace → Magicline Connect API**. Para datos del estudio y clases, usa el conector separado **Magicline Open API**.
2. Introduce la **URL de Magicline Connect API**, por ejemplo `https://your-studio.api.magicline.com/connect/v1`, y pulsa **Cargar estudios**. Elige un estudio o **Todos los estudios de esta cuenta**. Solicita la dirección al administrador del estudio. Connect API debe estar activada; las reservas también requieren sesiones de prueba en línea.
3. Elige **Conectar estudio**. Famulor comprueba el estudio. Los IDs se completan automáticamente; también se permite introducirlos manualmente. No se necesita clave API de Magicline.
4. Asigna la conexión a tu asistente. Las cinco funciones de estudio y sesiones de prueba están preseleccionadas. Selecciona varios estudios para compartir las mismas cinco herramientas.

Elige la **Preferencia de entrenador**: **Regla del estudio**, **Con entrenador** o **Sin entrenador**. La última opción solo funciona si el estudio lo permite. La preferencia se aplica a horarios y reservas.

Introduce la dirección de Connect API y pulsa **Cargar estudios**. Busca por nombre o ciudad y elige un estudio o **Todos los estudios de esta cuenta**. Los IDs se completan automáticamente. El asistente confirma la ubicación antes de consultar o reservar. También se permite introducir un ID manualmente.

## Cómo funciona la reserva

Confirma primero el estudio. El asistente consulta sus campos obligatorios y horarios, solicita los datos necesarios y pide al usuario que confirme la cita y el envío de sus datos. Solo confirma la reserva tras una respuesta satisfactoria. Nunca se presupone consentimiento publicitario.

## Entrenadores y disponibilidad

Magicline gestiona los entrenadores mediante los recursos del estudio. Solo se permite reservar con o sin entrenador según las reglas del estudio. No se puede seleccionar un entrenador concreto. Un horario disponible no constituye una reserva. En caso de conflicto, el asistente obtiene nuevos horarios y solicita otra elección.

## Resultados inciertos

Un tiempo de espera agotado no demuestra que la reserva haya fallado. Las solicitudes iguales simultáneas o repetidas están protegidas contra envíos duplicados. Si el resultado es incierto, consulta con el estudio antes de repetir la reserva.

## Automatizaciones

Conecta **Magicline Connect API** en **Automatizaciones → Conexiones**, o importa su conexión de Agent Tools. Usa las acciones de requisitos, horarios y reserva. La confirmación del usuario debe preceder a la reserva. Los datos de clases corresponden al conector separado Open API.

## API, MCP, CLI & SDK

`POST /api/v1/tools/magicline-connect/studios` · MCP `discover_magicline_connect_studios` · CLI `famulor discover-magicline-connect-studios`.

`POST /api/v1/tools/magicline-connect` · MCP `connect_magicline_connect` · CLI `famulor connect-magicline-connect`.

```bash theme={null}
famulor discover-magicline-connect-studios --connect-api-base-url "https://your-studio.api.magicline.com/connect/v1" --search "Bremen"
famulor connect-magicline-connect --studio-id "1234567890" --connect-api-base-url "https://your-studio.api.magicline.com/connect/v1" --name magicline_trial_sessions
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: studios } = await client.api.discoverMagiclineConnectStudios({ body: { connect_api_base_url: 'https://your-studio.api.magicline.com/connect/v1', search: 'Bremen' } });
console.log(studios.studios);
const { data: tool } = await client.api.connectMagiclineConnect({ body: {
  studio_id: '1234567890',
  connect_api_base_url: 'https://your-studio.api.magicline.com/connect/v1',
  name: 'magicline_trial_sessions',
  trainer_mode: 'studio_default',
} });
console.log(tool.id);
```

[Magicline Open API](/es/automations/magicline) · [Magicline Connect API](https://developer.sportalliance.com/apis/magicline/connectapi)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.