Skip to main content
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.
Magicline Open API · Magicline Connect API