SimplyBook.me icon

SimplyBook.me

Consume SimplyBook.me API

Overview

The node integrates with the SimplyBook.me API to create new bookings for services. It allows users to specify details such as the service, provider, location, category, date and time, number of bookings (count), and client information. This node is useful in scenarios where automated scheduling or appointment booking is needed, such as in salons, clinics, or any service-based business that uses SimplyBook.me for managing appointments.

Practical examples:

  • Automatically creating a booking when a customer fills out a form on a website.
  • Scheduling appointments based on availability fetched from SimplyBook.me.
  • Integrating booking creation into workflows that handle customer management or notifications.

Properties

Name Meaning
Service Name or ID Select a service from the list or specify its ID via expression.
Provider Name or ID Select a provider from the list or specify their ID via expression.
Location Name or ID Select a location from the list or specify its ID via expression.
Category Name or ID Select a category from the list or specify its ID via expression.
Date and Time Specify the date and time for the booking. This is a required field.
Count Number of bookings to create (default is 1).
Client Name or ID Select a client from the list or specify their ID via expression.

Output

The node outputs JSON data representing the newly created booking(s) with details returned by the SimplyBook.me API. The output typically includes booking identifiers, timestamps, service and provider details, client information, and status. If binary data were involved (e.g., attachments), it would be summarized accordingly, but this node focuses on JSON booking data.

Dependencies

  • Requires an API key credential for SimplyBook.me to authenticate requests.
  • The node depends on the SimplyBook.me API endpoint URL configured in the credentials.
  • Uses internal methods to load options dynamically for services, providers, locations, categories, and clients.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing invalid IDs or mismatched resource-operation combinations may result in errors from the API.
    • Incorrect date/time format or missing required fields like "Date and Time" can cause request rejections.
  • Error messages:

    • Authentication errors indicate problems with the API key or URL configuration.
    • Validation errors from the API often point to incorrect or missing input properties.
    • Network or timeout errors suggest connectivity issues with the SimplyBook.me service.

To resolve these, verify API credentials, ensure all required fields are correctly filled, and check network connectivity.

Links and References

Discussion