> ## 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

> Votre assistant réserve des séances d’essai sans clé API Magicline.

Votre assistant réserve des séances d’essai sans clé API Magicline.

## Connecter un studio

1. Ouvrez **Agent Tools → Marketplace → Magicline Connect API**. Pour les informations du studio et les cours, utilisez le connecteur distinct **Magicline Open API**.
2. Indiquez l’**URL de l’API Connect Magicline**, par exemple `https://your-studio.api.magicline.com/connect/v1`, puis choisissez **Charger les studios**. Choisissez un studio ou **Tous les studios de ce compte**. Demandez l’adresse à l’administrateur du studio. L’API Connect doit être activée ; les réservations nécessitent aussi les séances d’essai en ligne.
3. Choisissez **Connecter le studio**. Famulor vérifie le studio. Les identifiants sont renseignés automatiquement ; la saisie manuelle reste possible. Aucune clé API Magicline n’est nécessaire.
4. Attribuez la connexion à votre assistant. Les cinq fonctions de studio et d’essai sont présélectionnées. Sélectionnez plusieurs studios pour partager les mêmes cinq outils.

Choisissez la **Préférence de coach** : **Règle du studio**, **Avec un coach** ou **Sans coach**. Cette dernière option nécessite l’autorisation du studio. Le choix s’applique aux disponibilités et aux réservations.

Saisissez l’adresse API Connect et choisissez **Charger les studios**. Recherchez par nom ou ville, puis choisissez un studio ou **Tous les studios de ce compte**. Les identifiants sont remplis automatiquement. L’assistant confirme le lieu avant toute consultation ou réservation. La saisie manuelle reste possible.

## Déroulement d’une réservation

Confirmez d’abord le studio. L’assistant consulte les champs requis et les créneaux disponibles, recueille les informations nécessaires et demande à l’appelant de confirmer le rendez-vous et le partage de ses données. Il confirme la réservation uniquement après une réponse positive. Aucun consentement marketing n’est supposé.

## Coachs et disponibilités

Magicline gère les coachs selon les ressources du studio. La réservation avec ou sans coach dépend des règles du studio. Il n’est pas possible de choisir un coach précis. Un créneau disponible n’est pas une réservation. En cas de conflit, l’assistant recherche de nouveaux créneaux et demande un nouveau choix.

## Résultat incertain

Un délai dépassé ne signifie pas que la réservation a échoué. Les demandes identiques simultanées ou répétées sont protégées contre les doublons. Vérifiez avec le studio avant toute nouvelle tentative si le résultat est incertain.

## Automatisations

Connectez **Magicline Connect API** dans **Automatisations → Connexions**, ou importez sa connexion Agent Tools. Utilisez les actions de conditions, disponibilités et réservation. La confirmation de l’appelant doit précéder la réservation. Les données des cours utilisent le connecteur Open API distinct.

## 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](/fr/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.