Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Bookingmood

Scalekit connector
Open markdown

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.

Tools
55
What they doRead · write · destructive
35 · 12 · 835 read12 write8 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

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

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Bookingmood credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • bookingmood_activity_log_listList what changed in the organization and who changed it.Read-only

    List Activity Log

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

    Inputs

    created_atstring
    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.
    limitstring
    Maximum number of rows to return. Example: 25.
    offsetstring
    Number of rows to skip, for paging. Example: 0.
    orderstring
    Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
  • bookingmood_availability_getGet the availability calendar of one or more products.Read-only

    Get Availability

    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.

    Inputs

    perform_syncbooleanrequired
    true to sync external (iCal) calendars first; slower. Example: false.
    product_idsarrayrequired
    Product IDs to check, comma-separated. Example: ["1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10"].
    show_booked_asstringrequired
    How to show confirmed bookings: unavailable or booked. Example: unavailable.one of bookedunavailable
    show_closed_asstringrequired
    How to show blocked or closed periods: unavailable or closed. Example: unavailable.one of closedunavailable
    show_pending_asstringrequired
    How to treat pending bookings: TENTATIVE, CONFIRMED or CANCELLED. Example: TENTATIVE.one of CONFIRMEDTENTATIVECANCELLED
  • bookingmood_booking_details_listList the details guests filled in on booking forms.Read-only

    List Booking Details

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

    Inputs

    booking_idstring
    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.
    limitstring
    Maximum number of rows to return. Example: 25.
    offsetstring
    Number of rows to skip, for paging. Example: 0.
    orderstring
    Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
  • bookingmood_booking_getGet one booking by ID.Read-only

    Get Booking

    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.

    Inputs

    booking_idstringrequired
    ID (UUID) of the booking. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
  • bookingmood_bookings_listList bookings, with filters, column selection, sorting and paging.Read-only

    List Bookings

    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.

    Inputs

    confirmed_atstring
    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_atstring
    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.
    limitstring
    Maximum number of rows to return. Example: 25.
    offsetstring
    Number of rows to skip, for paging. Example: 0.
    orderstring
    Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
    referencestring
    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.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *,calendar_events(*).
    site_idstring
    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.
  • bookingmood_calendar_event_getGet one calendar event by ID.Read-only

    Get Calendar Event

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

    Inputs

    calendar_event_idstringrequired
    ID (UUID) of the calendar event. Example: 1f0c6a52-3a1e-4b7a-9d3e-2b5e8c9f7a10.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
  • bookingmood_calendar_event_notes_listList private notes on calendar events.Read-only

    List Calendar Event Notes

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

    Inputs

    calendar_event_idstring
    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.
    limitstring
    Maximum number of rows to return. Example: 25.
    offsetstring
    Number of rows to skip, for paging. Example: 0.
    orderstring
    Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: created_at.desc.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
  • bookingmood_calendar_events_listList calendar events (bookings, blocked periods and notes on the timeline), with filters by product, booking, type, status and dates.Read-only

    List Calendar Events

    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.

    Inputs

    booking_idstring
    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_datestring
    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.
    limitstring
    Maximum number of rows to return. Example: 25.
    offsetstring
    Number of rows to skip, for paging. Example: 0.
    orderstring
    Sort order as column.asc or column.desc, comma-separated for several columns, such as created_at.desc. Example: start_date.asc.
    product_idstring
    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.
    selectstring
    Columns to return, comma-separated, with optional embedded relations, such as id,name or *,calendar_events(*). Defaults to all columns. Example: *.
    start_datestring
    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.
    statusstring
    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.
    typestring
    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.