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

> Let your assistant book trial sessions without a Magicline API key.

Let your assistant book trial sessions without a Magicline API key.

## Set up your studio

1. Open **Agent Tools → Marketplace → Magicline Connect API**. For studio and course data, use the separate **Magicline Open API** connector.
2. Enter your **Magicline Connect API URL**, for example `https://your-studio.api.magicline.com/connect/v1`, and choose **Load studios**. Select a studio or **All studios in this account**. Ask your studio administrator for the address. Connect API must be enabled; trial bookings additionally require online trial sessions.
3. Choose **Connect studio**. Famulor checks the studio. Studio IDs are filled in automatically; manual entry is also available. No Magicline API key is required.
4. Assign the connection to your assistant. The five studio and trial session functions are selected automatically. Choose multiple studios to use the same five tools across them.

Choose **Trainer preference**: **Studio default**, **With a trainer**, or **Without a trainer**. The last option works only if the studio allows it. The preference applies to both availability searches and bookings.

Enter the Connect API address and choose **Load studios**. Search by name or city, then choose one studio or **All studios in this account**. IDs are filled in automatically. The assistant uses a compact set of tools for the enabled studios, confirms the location once and keeps using it until the caller names another studio. A manual ID remains available if needed.

## How booking works

First confirm the studio and whether it offers online trial sessions. The assistant then reads that studio’s required fields and available times, offers only returned times in the studio’s local time, collects the required details, and asks the caller to confirm the appointment and sharing their details before booking. The studio decides in Magicline which details are required; if the caller declines one, the assistant offers the studio’s contact details instead. Courses and class sessions cannot be booked with this connector. It announces success only after a successful booking response. Marketing consent is never assumed.

When a phone number is provided, use the area code for the studio’s country or include the international country code. For each offered time, keep the original slot value for the booking and use the studio’s local time when speaking.

## Trainers and availability

Magicline manages trainer availability through your studio’s configured resources. This connector books with or without a trainer only when the studio permits it. A specific trainer cannot be selected. Available times are not reservations; if a time fills up, the assistant loads fresh times and asks the caller to choose again.

## If the result is unclear

A timeout does not prove that booking failed. Matching concurrent or repeated requests are protected against duplicate submissions. If the outcome is unknown, check with the studio before attempting another booking.

## Automations

Connect **Magicline Connect API** under **Automations → Connections**, or import its Agent Tool connection. Use its requirements, slots and booking actions. Keep caller confirmation in your workflow before the booking action. Connect API does not provide course data through these tools.

## 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](https://docs.famulor.io/automations/magicline.md) · [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.