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

# SimplyBook.me

> Let your assistant check free times and book appointments in SimplyBook.me.

Let your assistant check services, staff and free times in your SimplyBook.me account and book appointments after the caller confirms.

## Set up your account

1. In SimplyBook.me, open **Custom Features → API** and copy the **REST API Endpoint** for your region, for example `https://user-api-v2.simplybook.it`. Create an **API User Key** for a staff user on the API User Keys page.
2. Use a dedicated staff user with only the permissions the assistant needs. The assistant can do whatever that user is allowed to do.
3. Open **Agent Tools → Marketplace → SimplyBook.me**. Choose the endpoint, enter your company login (the part before `.simplybook.me`), the staff user login and the API User Key. Use an API User Key, not a password: passwords require two-factor sign-in and stop working for automation.
4. Choose **Add**. The sign-in is checked before the connection is saved. Then assign the connection to your assistant.

> [!WARNING]
>
> Creating your first API User Key turns on email IP verification for staff password logins of your SimplyBook.me account. Other integrations that sign in with a password then need a key too.

To change the endpoint, staff login or key later, remove the tool and connect again.

## What the assistant can do

Enabled by default:

* Company information, services and staff (staff contact details are never shared).
* Free times for a service, with or without a chosen staff member, and the next free time.
* The details a service requires before booking.
* Booking an appointment.

Optional, choose them under **Edit**:

* Find a client by email address and list their upcoming appointments. Anyone who knows the email address can hear those times, so enable this only if that is acceptable for your business.
* Look up a booking and list bookings in a date range, including client contact details. Use this for automations and back-office assistants, not for assistants that talk to callers.
* Cancel an appointment.

## How booking works

The assistant first loads which details the service requires, then the free times. It offers only times SimplyBook.me returned, in your business time zone. It collects name, email address and any required details, reads back service, staff, date and time, and books only after the caller says yes. It announces success only after SimplyBook.me confirmed the booking. If your service needs approval, the assistant says that the business will confirm the appointment.

SimplyBook.me sends its usual confirmation emails or messages to your client. Free times are not reservations: if a time fills up, the assistant loads fresh times and asks again.

## If the result is unclear

A timeout does not prove that a booking failed. Repeated or parallel requests are protected against double bookings. If the assistant reports an unknown outcome, check SimplyBook.me before booking again.

## Cancelling

Cancellation is off by default. The caller must give the booking code from the confirmation email and the email address used for the booking; both must match. To move an appointment, the assistant books the new time and then cancels the old one, each after the caller confirms. Rescheduling in one step is not available yet.

## Test safely

A Test Chat or a voice test makes real bookings and sends real notifications. Test with a test service and cancel the booking afterwards. Text simulations do not call SimplyBook.me.

## Channels

On the phone and in web chat the assistant sees the full booking instructions. In WhatsApp, Messenger and email it may need one extra message to get the booking details right.

## Automations

Connect **SimplyBook.me** under **Automations → Connections**, or import its Agent Tool connection. Every tool is available as an action. A booking action needs the availability reference from a previous **Available slots** or **Next available slot** step, and a **Confirmed by the client** value that is true only after the client confirmed. Triggers for new, changed or cancelled bookings are not available yet.

## API, MCP, CLI & SDK

`POST /api/v1/tools/simplybook` · MCP `connect_simplybook` · CLI `famulor connect-simplybook`.

`client.api.connectSimplybook` needs `famulor-sdk` 0.2.11 or later. Update the CLI with `npm install --global famulor` before you use `connect-simplybook`.

```bash theme={null}
famulor connect-simplybook --api-host "https://user-api-v2.simplybook.it" --company-login "mycompany" --user-login "assistant" --api-key "$SIMPLYBOOK_API_KEY" --name simplybook
```

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

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectSimplybook({ body: {
  api_host: 'https://user-api-v2.simplybook.it',
  company_login: 'mycompany',
  user_login: 'assistant',
  api_key: process.env.SIMPLYBOOK_API_KEY,
  name: 'simplybook',
} });
console.log(tool.id);
```

[SimplyBook.me REST API](https://simplybook.me/en/api/developer-api/tab/rest_api)


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