SimplyBook.me icon

SimplyBook.me

Consume SimplyBook.me API
Join our community

Actions15

Overview

The node integrates with the SimplyBook.me API to retrieve a timeline of available or booked slots within a specified date range. It is useful for scheduling applications, appointment management, or any scenario where you need to visualize or process time-based availability data for services and providers.

Typical use cases include:

  • Fetching all booking slots for a service provider between two dates.
  • Displaying a timeline of available appointment slots for clients.
  • Analyzing slot availability trends over a period.

For example, a business could use this node to pull all available slots for a particular service and provider in the upcoming week to display on their booking website.

Properties

Name Meaning
Service Name or ID Select or specify the service by name or ID to filter slots related to that service.
Provider Name or ID Select or specify the provider by name or ID to filter slots related to that provider.
Date From The start date/time from which to retrieve slots (required). Defines the beginning of the timeline window.
Date To The end date/time until which to retrieve slots (required). Defines the end of the timeline window.
Count Number of slots to retrieve. Controls how many slot entries are returned.
Product ID Names or IDs Select one or multiple products by name or ID to filter slots associated with those products (required).
Skip Min Max Restriction Boolean flag to skip minimum and maximum restrictions when retrieving slots. If true, the node ignores these constraints.
With Available Slots Boolean flag indicating whether to include only slots that are currently available. If true, filters out unavailable slots.
Booking ID Optionally specify a booking ID to filter slots related to a particular booking.

Output

The node outputs JSON data representing the slots timeline matching the input criteria. Each item in the output typically includes details such as slot start and end times, associated service and provider information, availability status, and possibly linked booking details.

If binary data were involved (e.g., attachments), it would be summarized here, but this node focuses on JSON slot data.

Dependencies

  • Requires an active SimplyBook.me API credential configured in n8n with the base URL and authentication token.
  • The node depends on the SimplyBook.me API being accessible and the credentials having sufficient permissions to read slot and booking data.

Troubleshooting

  • Empty results: Ensure the date range (Date From and Date To) is valid and that the selected service, provider, and products actually have slots in that range.
  • Authentication errors: Verify that the API key or token is correctly set up in the credentials and has not expired.
  • Invalid property values: Check that IDs or names used for services, providers, and products exist and are spelled correctly.
  • API rate limits: If many requests are made in a short time, the API might throttle calls; consider adding delays or reducing request frequency.

Links and References

Discussion