SimplyBook.me icon

SimplyBook.me

Consume SimplyBook.me API
Join our community

Actions15

Overview

The node integrates with the SimplyBook.me API to retrieve scheduling information. Specifically, the "Get First Available Slot" operation under the "Slot" resource fetches the earliest available appointment slot for a given service and provider on a specified date. This is useful in scenarios where you want to quickly find the next open time for booking without retrieving all slots.

Practical examples include:

  • Displaying the soonest available appointment time to customers on a booking website.
  • Automating appointment scheduling by selecting the first free slot programmatically.
  • Checking availability before creating a new booking to avoid conflicts.

Properties

Name Meaning
Service Name or ID Select or specify the service for which to find an available slot. Options are loaded dynamically.
Provider Name or ID Select or specify the provider (e.g., staff member) offering the service. Options are loaded dynamically.
Date The date on which to search for the first available slot. This is required.
Count Number of available slots to retrieve starting from the earliest one. Defaults to 1 and is required.

Output

The node outputs JSON data representing the details of the first available slot(s) found. This typically includes information such as slot start time, duration, associated service and provider IDs, and possibly booking status or other metadata depending on the API response.

If multiple slots are requested via the "Count" property, the output will contain an array of slot objects up to that count.

No binary data output is indicated.

Dependencies

  • Requires an active SimplyBook.me account and API access.
  • Needs an API authentication credential configured in n8n (an API key or token).
  • The base URL for the SimplyBook.me API must be set in the credentials.
  • Dynamic loading of services and providers depends on API endpoints to populate options.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication errors.
    • Specifying a date with no available slots may return empty results.
    • Incorrect service or provider IDs can lead to no matches found.
  • Error messages:
    • Authentication failures: Verify API key/token and base URL.
    • Validation errors: Ensure required fields like date and count are provided.
    • Empty responses: Confirm that the service and provider have availability on the chosen date.

Links and References

Discussion