> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Bookingmood

The Bookingmood connector lets your AI agent act in each user's Bookingmood account. Each user connects their own Bookingmood access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 55 tools.

**Authentication:** Bearer Token
**Categories:** Calendar, Productivity
**Tools:** 55: 35 read, 12 write, 8 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BOOKINGMOOD)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Bookingmood connection

   In **AgentKit > Connections**, create a Bookingmood connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'bookingmood'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Bookingmood:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'bookingmood_activity_log_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "bookingmood"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Bookingmood:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="bookingmood_activity_log_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Bookingmood credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'bookingmood_activity_log_list',
  toolInput: {},
  connector: 'bookingmood',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="bookingmood_activity_log_list",
    tool_input={},
    connection_name="bookingmood",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `bookingmood_activity_log_list`

List Activity Log · Read-only

List what changed in the organization and who changed it.
Returns each change's table, record, action, user and time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on created at. Example: gte.2026-06-01.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_availability_get`

Get Availability · Read-only

Get the availability calendar of one or more products.
Returns, per product, the available, tentative and unavailable periods.
Use bookingmood_products_search to find products free for specific dates and guests.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `perform_sync` (`boolean`, required): true to sync external (iCal) calendars first; slower. Example: false.
- `product_ids` (`array`, required): Product IDs to check, comma-separated. Example: ["1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10"].
- `show_booked_as` (`string`, required): How to show confirmed bookings: unavailable or booked. Example: unavailable. One of: `booked`, `unavailable`.
- `show_closed_as` (`string`, required): How to show blocked or closed periods: unavailable or closed. Example: unavailable. One of: `closed`, `unavailable`.
- `show_pending_as` (`string`, required): How to treat pending bookings: TENTATIVE, CONFIRMED or CANCELLED. Example: TENTATIVE. One of: `CONFIRMED`, `TENTATIVE`, `CANCELLED`.

Example input: `{"perform_sync":true,"product_ids":["1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10"],"show_booked_as":"booked","show_closed_as":"closed","show_pending_as":"CONFIRMED"}`

### `bookingmood_booking_details_list`

List Booking Details · Read-only

List the details guests filled in on booking forms.
Returns each value with its booking and service (form field).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on booking id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_booking_get`

Get Booking · Read-only

Get one booking by ID.
Returns a one-item array with the booking; set select to embed related rows, such as *,calendar_events(*),invoices(*),payments(*).
Use bookingmood_bookings_list to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, required): ID (UUID) of the booking. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"booking_id":"<booking_id>"}`

### `bookingmood_bookings_list`

List Bookings · Read-only

List bookings, with filters, column selection, sorting and paging.
Returns each booking's ID, reference, currency, confirmation time and creation time; embed related rows with select.
Use bookingmood_calendar_events_list for dates and statuses of stays.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `confirmed_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on confirmed at. Example: not.is.null.
- `created_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on created at. Example: gte.2026-01-01.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `reference` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on reference. Example: eq.BM-1042.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *,calendar_events(*).
- `site_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on site id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{}`

### `bookingmood_calendar_event_get`

Get Calendar Event · Read-only

Get one calendar event by ID.
Returns a one-item array with the event's product, booking, type, status, title, dates and occupancy.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `calendar_event_id` (`string`, required): ID (UUID) of the calendar event. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"calendar_event_id":"<calendar_event_id>"}`

### `bookingmood_calendar_event_notes_list`

List Calendar Event Notes · Read-only

List private notes on calendar events.
Returns each note's ID, event, author and text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `calendar_event_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on calendar event id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_calendar_events_list`

List Calendar Events · Read-only

List calendar events (bookings, blocked periods and notes on the timeline), with filters by product, booking, type, status and dates.
Returns each event's ID, product, booking, type, status, title, start and end dates and occupancy.
Use it to see what is booked when.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on booking id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `end_date` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on end date. Example: lte.2026-07-31.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: start_date.asc.
- `product_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on product id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
- `start_date` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on start date. Example: gte.2026-07-01.
- `status` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on status. Example: eq.CONFIRMED.
- `type` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on type. Example: eq.booking.

Example input: `{}`

### `bookingmood_capacity_groups_list`

List Capacity Groups · Read-only

List capacity groups, such as adults, children or pets.
Returns each group's ID and name.
Use the IDs as keys of occupancy in bookingmood_booking_create and bookingmood_products_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_contact_bookings_list`

List Contact Bookings · Read-only

List links between contacts and bookings.
Returns each link's contact ID and booking ID.
Use it to find a guest's bookings or a booking's guests.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on booking id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `contact_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on contact id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_contact_get`

Get Contact · Read-only

Get one contact by ID.
Returns a one-item array with the contact's name, email, phone, address, language and notes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID (UUID) of the contact. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"contact_id":"<contact_id>"}`

### `bookingmood_contacts_list`

List Contacts · Read-only

List contacts (guests and other people), with filters, sorting and paging.
Returns each contact's ID, name, email, phone and address.
Use bookingmood_contact_get for one contact.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on email. Example: eq.jane@example.com.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `name` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on name. Example: ilike.*smith*.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: name.asc.
- `phone` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on phone. Example: eq.+31612345678.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_coupons_list`

List Coupons · Read-only

List coupon codes guests can use for discounts.
Returns each coupon's ID, code, description, quota, scope and definition.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `code` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on code. Example: eq.SUMMER10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_external_calendars_list`

List External Calendars · Read-only

List imported iCal calendars used to sync bookings with platforms such as Airbnb or Booking.com.
Returns each calendar's ID, product, URL and last sync.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_invoice_get`

Get Invoice · Read-only

Get one invoice by ID.
Returns a one-item array with the invoice; set select to embed lines, such as *,line_items(*).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`string`, required): ID (UUID) of the invoice. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"invoice_id":"<invoice_id>"}`

### `bookingmood_invoices_list`

List Invoices · Read-only

List booking invoices, with filters, sorting and paging.
Returns each invoice's ID, reference, booking and creation date.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on booking id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `reference` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on reference. Example: eq.INV-2026-001.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_line_items_list`

List Invoice Line Items · Read-only

List invoice line items.
Returns each line's invoice, description, quantity and price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on invoice id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_members_list`

List Members · Read-only

List the members of the organization.
Returns each member's user ID, role and profile.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_message_templates_list`

List Message Templates · Read-only

List reusable email and text message templates.
Returns each template's ID, name, trigger and content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_messages_list`

List Messages · Read-only

List emails and text messages scheduled or sent to guests.
Returns each message's ID, recipient, subject, status and send time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_organizations_list`

List Organizations · Read-only

List the organizations the API key can reach (an API key reaches one).
Returns each organization's ID, name, currency and settings.
Use it to get the organization_id that create tools need.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_payments_list`

List Payments · Read-only

List booking payments, planned or paid, with filters, sorting and paging.
Returns each payment's ID, booking, amount, paid amount, currency, due date and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on booking id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `due_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on due at. Example: lte.2026-07-01.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
- `status` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on status. Example: eq.paid.

Example input: `{}`

### `bookingmood_price_calendar_entries_list`

List Price Calendar Entries · Read-only

List rate and availability configurations of units, each applying to a period.
Returns each entry's product, period and rate settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `product_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on product id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_product_get`

Get Product · Read-only

Get one product (unit) by ID.
Returns a one-item array with the product's name, description, address, timezone, currency, rent period and booking settings.
Use bookingmood_products_list to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`string`, required): ID (UUID) of the product. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"product_id":"<product_id>"}`

### `bookingmood_products_list`

List Products · Read-only

List bookable products (units, such as rooms, cabins or rentals), with column selection, sorting and paging.
Returns each product's ID, name, timezone, currency, rent period and booking settings.
Use bookingmood_products_search to find products free for given dates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deleted_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on deleted at. Example: is.null.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `organization_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on organization id. Example: eq.5b8d2f61-0c3e-4f6a-8a1b-7c9d0e1f2a3b.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_products_search`

Search Available Products · Read-only

Search products that are available for a date interval and occupancy, optionally filtered by attribute options or product IDs.
Returns the matching products with their availability and prices.
Use it before bookingmood_booking_create to find a free unit.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `interval` (`object`, required): Dates to search, as an object with start and end dates, such as {"start": "2026-07-01", "end": "2026-07-08"}. Example: {"start": "2026-07-01", "end": "2026-07-08"}.
- `occupancy` (`object`, optional): Guests per capacity group, keyed by capacity_groups.id, such as {"<capacity group id>": 2}. Get IDs from bookingmood_capacity_groups_list. Example: {"3e1f0a52-6b7c-4d8e-9f01-23456789abcd": 2}.
- `option_ids` (`array`, optional): Attribute option IDs the products must have. Example: [].
- `product_ids` (`array`, optional): Only search these product IDs. Example: ["1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10"].
- `show_booked_as` (`string`, optional): How to show confirmed bookings: unavailable or booked. Example: unavailable. One of: `booked`, `unavailable`.
- `show_closed_as` (`string`, optional): How to show blocked or closed periods: unavailable or closed. Example: unavailable. One of: `closed`, `unavailable`.
- `show_pending_as` (`string`, optional): How to treat pending bookings: TENTATIVE, CONFIRMED or CANCELLED. Example: TENTATIVE. One of: `CONFIRMED`, `TENTATIVE`, `CANCELLED`.

Example input: `{"interval":{"start":"2026-07-01","end":"2026-07-08"}}`

### `bookingmood_refunds_list`

List Refunds · Read-only

List refunds of booking payments.
Returns each refund's payment, amount and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `payment_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on payment id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_reviews_list`

List Reviews · Read-only

List guest reviews, with filters, sorting and paging.
Returns each review's ID, author, rating, content, status and booking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `rating` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on rating. Example: gte.4.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
- `status` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on status. Example: eq.pending.

Example input: `{}`

### `bookingmood_seasons_list`

List Seasons · Read-only

List pricing seasons.
Returns each season's ID, name and date ranges.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_services_list`

List Services · Read-only

List services: booking-form fields and extras such as cleaning fees, guest name or email fields.
Returns each service's ID, name, type and settings.
Use service IDs as keys of form_values in bookingmood_booking_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_sites_list`

List Sites · Read-only

List the booking websites of the organization.
Returns each site's ID, name and domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_tasks_list`

List Tasks · Read-only

List tasks on calendar events, such as cleaning or check-in.
Returns each task's ID, label, event, due time and completion time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `calendar_event_id` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on calendar event id. Example: eq.1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `completed_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on completed at. Example: is.null.
- `due_at` (`string`, optional): PostgREST filter: an operator, a dot and a value, such as eq.<value>, neq.<value>, gte.2026-01-01, lt.2026-02-01, in.(a,b) or ilike.*text*. Filters on due at. Example: lte.2026-07-08.
- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_taxes_list`

List Taxes · Read-only

List the taxes configured in the organization.
Returns each tax's ID, name and rate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_webhooks_list`

List Webhooks · Read-only

List webhooks registered for the organization.
Returns each webhook's ID, endpoint URL, events and disabled time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_widgets_list`

List Widgets · Read-only

List embeddable booking widgets.
Returns each widget's ID, name, type and settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Maximum number of rows to return. Example: 25.
- `offset` (`string`, optional): Number of rows to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{}`

### `bookingmood_booking_create`

Create Booking · Write

Book a product for a date interval and occupancy, with the guest's booking-form values.
Returns the new booking, its calendar event and, when payment is due, a payment URL.
Check free dates first with bookingmood_products_search or bookingmood_availability_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `interval` (`object`, required): Dates to book, as an object with start and end, such as {"start": "2026-07-01", "end": "2026-07-08"}. Example: {"start": "2026-07-01", "end": "2026-07-08"}.
- `occupancy` (`object`, required): Guests per capacity group, keyed by capacity_groups.id, such as {"<capacity group id>": 2}. Example: {"3e1f0a52-6b7c-4d8e-9f01-23456789abcd": 2}.
- `product_id` (`string`, required): ID of the product to book. Get it from bookingmood_products_list. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `coupon_codes` (`array`, optional): Coupon codes to apply. Example: ["SUMMER10"].
- `currency` (`string`, optional): The currency to use for the booking. Defaults to the product's currency. See [the widget docs](/docs/widgets/embed-customization) for the allowed values. Example: EUR. One of: `ARS`, `AUD`, `BRL`, `BYN`, `CAD`, `CHF`, `CLP`, `CNY`, `COP`, `CZK`, `DKK`, `EGP`, `EUR`, `GBP`, `HKD`, `HUF`, `ILS`, `INR`, `JPY`, `KRW`, `KYD`, `MAD`, `MXN`, `MYR`, `NGN`, `NOK`, `NZD`, `PEN`, `PHP`, `PLN`, `RON`, `RUB`, `SEK`, `SGD`, `THB`, `TRY`, `TWD`, `UAH`, `USD`, `XOF`, `VND`, `ZAR`.
- `failure_url` (`string`, optional): URL to send the guest to when payment fails. Example: https://example.com/failed.
- `form_values` (`object`, optional): Booking form values keyed by services.id (guest name, email and other fields). Get service IDs from bookingmood_services_list. Example: {"7a2b3c4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d": "jane@example.com"}.
- `language` (`string`, optional): The user's preferred language. Example: en-US. One of: `be-BY`, `bg-BG`, `cs-CZ`, `da-DK`, `de-DE`, `en-GB`, `en-NZ`, `en-US`, `es-ES`, `eu-ES`, `fr-FR`, `gr-EL`, `he-IL`, `hr-HR`, `hu-HU`, `it-IT`, `ja-JP`, `lt-LT`, `lv-LV`, `nl-NL`, `nn-NO`, `pl-PL`, `pt-BR`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sr-Cyrl`, `sr-Latn`, `sv-SE`, `tr-TR`, `uk-UA`.
- `redirect_url` (`string`, optional): URL to send the guest to after booking. Example: https://example.com/thanks.
- `show_pending_as` (`string`, optional): How to interpret pending events when checking if the booking is possible. Defaults to `TENTATIVE`. Example: TENTATIVE. One of: `CONFIRMED`, `TENTATIVE`, `CANCELLED`.

Example input: `{"interval":{"start":"2026-07-01","end":"2026-07-08"},"occupancy":{"3e1f0a52-6b7c-4d8e-9f01-23456789abcd":2},"product_id":"<product_id>"}`

### `bookingmood_calendar_event_note_create`

Create Calendar Event Note · Write

Add a private note to a calendar event.
Returns the new note.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `calendar_event_id` (`string`, required): ID of the calendar event. Get it from bookingmood_calendar_events_list. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `note` (`string`, required): Text of the note. Example: Guest asked for a baby cot.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"calendar_event_id":"<calendar_event_id>","note":"<note>"}`

### `bookingmood_calendar_event_update`

Update Calendar Event · Write

Update a calendar event's status, title, notes or dates, for example to confirm or cancel a booking.
Returns the updated event.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `calendar_event_id` (`string`, required): ID (UUID) of the calendar event to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `end_date` (`string`, optional): New end date, YYYY-MM-DD. Example: 2026-07-08.
- `notes` (`string`, optional): Private notes about the event. Example: Late arrival.
- `start_date` (`string`, optional): New start date, YYYY-MM-DD. Example: 2026-07-01.
- `status` (`string`, optional): New status: CONFIRMED, TENTATIVE or CANCELLED. Example: CONFIRMED. One of: `CANCELLED`, `TENTATIVE`, `CONFIRMED`.
- `title` (`string`, optional): Title of the event. Example: Smith family.

Example input: `{"calendar_event_id":"<calendar_event_id>"}`

### `bookingmood_contact_create`

Create Contact · Write

Create a contact (guest).
Returns the new contact with its ID.
Use bookingmood_contacts_list first to avoid duplicates.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `organization_id` (`string`, required): ID (UUID) of the organization. Get it from bookingmood_organizations_list. Example: 5b8d2f61-0c3e-4f6a-8a1b-7c9d0e1f2a3b.
- `city` (`string`, optional): City of the contact. Example: Utrecht.
- `company_name` (`string`, optional): Company name of the contact, for invoices. Example: Acme BV.
- `country` (`string`, optional): Country code, such as NL. Example: NL.
- `email` (`string`, optional): Email address of the contact. Example: jane@example.com.
- `first_name` (`string`, optional): First name of the contact. Example: Jane.
- `language` (`string`, optional): Language of the contact. Example: en-US. One of: `be-BY`, `bg-BG`, `cs-CZ`, `da-DK`, `de-DE`, `en-GB`, `en-NZ`, `en-US`, `es-ES`, `eu-ES`, `fr-FR`, `gr-EL`, `he-IL`, `hr-HR`, `hu-HU`, `it-IT`, `ja-JP`, `lt-LT`, `lv-LV`, `nl-NL`, `nn-NO`, `pl-PL`, `pt-BR`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sr-Cyrl`, `sr-Latn`, `sv-SE`, `tr-TR`, `uk-UA`.
- `last_name` (`string`, optional): Last name of the contact. Example: Smith.
- `meta` (`object`, optional): Extra metadata as a JSON object; send {} when you have none. Example: {}.
- `notes` (`string`, optional): Private notes about the contact. Example: Prefers late check-in.
- `phone` (`string`, optional): Phone number of the contact. Example: +31612345678.
- `province` (`string`, optional): Province of the contact. Example: Utrecht.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
- `street` (`string`, optional): Street address of the contact. Example: Lakeweg 1.
- `street2` (`string`, optional): Second line of the street address of the contact. Example: Apt 2.
- `zip` (`string`, optional): Postal code of the contact. Example: 3511 AB.

Example input: `{"organization_id":"<organization_id>"}`

### `bookingmood_contact_update`

Update Contact · Write

Update a contact's name, email, phone, address or notes.
Returns the updated contact.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID (UUID) of the contact to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `city` (`string`, optional): City of the contact. Example: Utrecht.
- `company_name` (`string`, optional): Company name of the contact, for invoices. Example: Acme BV.
- `country` (`string`, optional): Country code, such as NL. Example: NL.
- `email` (`string`, optional): Email address of the contact. Example: jane@example.com.
- `first_name` (`string`, optional): First name of the contact. Example: Jane.
- `language` (`string`, optional): Language of the contact. Example: en-US. One of: `be-BY`, `bg-BG`, `cs-CZ`, `da-DK`, `de-DE`, `en-GB`, `en-NZ`, `en-US`, `es-ES`, `eu-ES`, `fr-FR`, `gr-EL`, `he-IL`, `hr-HR`, `hu-HU`, `it-IT`, `ja-JP`, `lt-LT`, `lv-LV`, `nl-NL`, `nn-NO`, `pl-PL`, `pt-BR`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sr-Cyrl`, `sr-Latn`, `sv-SE`, `tr-TR`, `uk-UA`.
- `last_name` (`string`, optional): Last name of the contact. Example: Smith.
- `meta` (`object`, optional): Extra metadata as a JSON object; send {} when you have none. Example: {}.
- `notes` (`string`, optional): Private notes about the contact. Example: Prefers late check-in.
- `phone` (`string`, optional): Phone number of the contact. Example: +31612345678.
- `province` (`string`, optional): Province of the contact. Example: Utrecht.
- `street` (`string`, optional): Street address of the contact. Example: Lakeweg 1.
- `street2` (`string`, optional): Second line of the street address of the contact. Example: Apt 2.
- `zip` (`string`, optional): Postal code of the contact. Example: 3511 AB.

Example input: `{"contact_id":"<contact_id>"}`

### `bookingmood_member_invite`

Invite Member · Write

Invite a person to the organization as a member with the user role.
Returns the new member.
The invitee gets an email.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email address of the person to invite. Example: colleague@example.com.
- `language` (`string`, optional): Preferred language, such as en-US. Example: en-US. One of: `be-BY`, `bg-BG`, `cs-CZ`, `da-DK`, `de-DE`, `en-GB`, `en-NZ`, `en-US`, `es-ES`, `eu-ES`, `fr-FR`, `gr-EL`, `he-IL`, `hr-HR`, `hu-HU`, `it-IT`, `ja-JP`, `lt-LT`, `lv-LV`, `nl-NL`, `nn-NO`, `pl-PL`, `pt-BR`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sr-Cyrl`, `sr-Latn`, `sv-SE`, `tr-TR`, `uk-UA`.
- `name` (`string`, optional): Name of the person. Example: Sam Lee.

Example input: `{"email":"<email>"}`

### `bookingmood_payment_update`

Update Payment · Write

Update a payment, for example to record an offline payment as paid.
Returns the updated payment.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `payment_id` (`string`, required): ID (UUID) of the payment to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `completed_at` (`string`, optional): Time the payment completed, ISO 8601. Example: 2026-06-01T12:00:00Z.
- `due_at` (`string`, optional): Due date, ISO 8601. Example: 2026-06-15T00:00:00Z.
- `offline` (`boolean`, optional): true if paid outside Bookingmood, such as by bank transfer. Example: true.
- `paid` (`integer`, optional): Amount paid so far, in the smallest currency unit (cents). Example: 25000.
- `reference` (`string`, optional): Reference of the payment. Example: Bank transfer 123.

Example input: `{"payment_id":"<payment_id>"}`

### `bookingmood_product_create`

Create Product · Write

Create a product (bookable unit) with sensible default settings.
Returns the new product with its ID.
Use bookingmood_product_update afterwards to set the description, address and booking rules.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`object`, required): Product name per language, as an object with a default key, such as {"default": "Cabin", "nl": "Hut"}. Example: {"default": "Lake Cabin"}.
- `rent_period` (`string`, required): Period the product is rented by. Example: nightly. One of: `nightly`, `daily`.
- `timezone` (`string`, required): IANA time zone of the product, such as Europe/Amsterdam. Example: Europe/Amsterdam.

Example input: `{"name":{"default":"Lake Cabin"},"rent_period":"nightly","timezone":"<timezone>"}`

### `bookingmood_product_update`

Update Product · Write

Update a product's name, description, address, currency or booking rules.
Returns the updated product.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`string`, required): ID (UUID) of the product to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `approximate_address` (`string`, optional): Approximate address of the unit. Example: Utrecht, NL.
- `confirmation_message` (`object`, optional): Message shown after booking, per language, such as {"default": "Thanks for booking!"}. Example: {"default": "Thanks for booking!"}.
- `cooldown_time` (`integer`, optional): Minimum number of days between bookings. Example: 0.
- `currency` (`string`, optional): Currency bookings are made in. Example: EUR. One of: `ARS`, `AUD`, `BRL`, `BYN`, `CAD`, `CHF`, `CLP`, `CNY`, `COP`, `CZK`, `DKK`, `EGP`, `EUR`, `GBP`, `HKD`, `HUF`, `ILS`, `INR`, `JPY`, `KRW`, `KYD`, `MAD`, `MXN`, `MYR`, `NGN`, `NOK`, `NZD`, `PEN`, `PHP`, `PLN`, `RON`, `RUB`, `SEK`, `SGD`, `THB`, `TRY`, `TWD`, `UAH`, `USD`, `VND`, `XOF`, `ZAR`.
- `description` (`object`, optional): Description per language, such as {"default": "Cosy cabin by the lake"}. Example: {"default": "Cosy cabin by the lake"}.
- `exact_address` (`string`, optional): Exact address of the unit. Example: Lakeweg 1, Utrecht.
- `free_cancellation_days` (`integer`, optional): Number of days before arrival until which guests can cancel for free, or null when there is no free cancellation. Informational: shown to guests and sent to Google Vacation Rentals, but it doesn't refund anything. Example: 14.
- `hide_exact_address` (`boolean`, optional): Whether to hide the exact address from guests until their booking is confirmed. Example: true.
- `interaction` (`string`, optional): How guests book the unit. Example: book. One of: `book`, `request`.
- `latest_arrival_time` (`string`, optional): Latest time guests can book for the same day. Example: 22:00.
- `name` (`object`, optional): Product name per language, such as {"default": "Lake Cabin"}. Example: {"default": "Lake Cabin"}.
- `request_status` (`string`, optional): Status of new booking requests: `TENTATIVE` keeps them pending until they are confirmed, `CONFIRMED` confirms them right away. Doesn't apply to instant bookings. Example: CANCELLED. One of: `CANCELLED`, `TENTATIVE`, `CONFIRMED`.
- `timezone` (`string`, optional): Timezone of the unit. Example: Europe/Amsterdam.

Example input: `{"product_id":"<product_id>"}`

### `bookingmood_review_update`

Moderate Review · Write

Approve, reject or hold a guest review.
Returns the updated review.
Review widgets show only approved reviews.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `review_id` (`string`, required): ID (UUID) of the review to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `status` (`string`, optional): Moderation status: approved, pending or rejected. Example: approved. One of: `approved`, `pending`, `rejected`.

Example input: `{"review_id":"<review_id>"}`

### `bookingmood_task_create`

Create Task · Write

Create a task on a calendar event, such as cleaning after departure.
Returns the new task.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `calendar_event_id` (`string`, required): ID of the calendar event. Get it from bookingmood_calendar_events_list. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `label` (`string`, required): Task text. Example: Clean the cabin.
- `due_at` (`string`, optional): Due time, ISO 8601. Example: 2026-07-08T11:00:00Z.
- `schedule` (`string`, optional): When the task is due: arrival, departure or manual (use due_at). Example: departure. One of: `arrival`, `departure`, `manual`.
- `select` (`string`, optional): Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.

Example input: `{"calendar_event_id":"<calendar_event_id>","label":"<label>"}`

### `bookingmood_task_update`

Update Task · Write

Update a task's label or due time, or mark it done by setting completed_at.
Returns the updated task.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`string`, required): ID (UUID) of the task to update. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
- `completed_at` (`string`, optional): Time the task was done, ISO 8601; set it to mark the task complete. Example: 2026-07-08T12:30:00Z.
- `due_at` (`string`, optional): Timestamp at which the task is due. Example: 2026-07-08T11:00:00Z.
- `label` (`string`, optional): Label of the task. Example: Clean the cabin.
- `schedule` (`string`, optional): Schedule of the task relative to the event. Example: manual. One of: `arrival`, `departure`, `manual`.

Example input: `{"task_id":"<task_id>"}`

### `bookingmood_booking_delete`

Delete Booking · Destructive

Delete a booking with its calendar events, invoices and payments.
Returns an empty response on success.
To cancel a stay but keep the record, set the calendar event status to CANCELLED with bookingmood_calendar_event_update.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, required): ID (UUID) of the booking to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"booking_id":"<booking_id>"}`

### `bookingmood_calendar_event_delete`

Delete Calendar Event · Destructive

Delete a calendar event, such as a blocked period or note.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `calendar_event_id` (`string`, required): ID (UUID) of the calendar event to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"calendar_event_id":"<calendar_event_id>"}`

### `bookingmood_calendar_event_note_delete`

Delete Calendar Event Note · Destructive

Delete a private note from a calendar event.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `note_id` (`string`, required): ID (UUID) of the note to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"note_id":"<note_id>"}`

### `bookingmood_contact_delete`

Delete Contact · Destructive

Delete a contact.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID (UUID) of the contact to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"contact_id":"<contact_id>"}`

### `bookingmood_coupon_delete`

Delete Coupon · Destructive

Delete a coupon code.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `coupon_id` (`string`, required): ID (UUID) of the coupon to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"coupon_id":"<coupon_id>"}`

### `bookingmood_product_delete`

Delete Product · Destructive

Delete a product (unit) and its related data.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`string`, required): ID (UUID) of the product to delete. Get it from bookingmood_products_list. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"product_id":"<product_id>"}`

### `bookingmood_task_delete`

Delete Task · Destructive

Delete a task.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`string`, required): ID (UUID) of the task to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"task_id":"<task_id>"}`

### `bookingmood_webhook_delete`

Delete Webhook · Destructive

Delete a webhook.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): ID (UUID) of the webhook to delete. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.

Example input: `{"webhook_id":"<webhook_id>"}`

## Related

Other Calendar connectors ([all 25](/agentkit/connectors/?category=calendar)):

- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools
- [Zoom](/agentkit/connectors/zoom/): Scalekit connector, OAuth, 58 tools
- [Calendly](/agentkit/connectors/calendly/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
