SimplyBook.me icon

SimplyBook.me

Consume SimplyBook.me API

Overview

The node integrates with the SimplyBook.me API to retrieve available booking slots for services on a specified date. It is useful in scenarios where users want to check real-time availability of service providers and products before making a booking. For example, a business could use this node to display open appointment times for different services and providers on their website or within an automation workflow.

Properties

Name Meaning
Service Name or ID Select a service from a dropdown list or specify its ID via expression. Determines which service's slots to query.
Provider Name or ID Select a provider from a dropdown list or specify its ID via expression. Filters slots by the chosen provider.
Date The specific date to check for available slots. This is a required field.
Count Number of slots to retrieve. Required; defaults to 1.
Product ID Names or IDs Multi-select list of products to filter slots by. Can choose from the list or specify IDs via expression. Required when applicable.

Output

The node outputs JSON data representing the available slots matching the input criteria. Each slot typically includes details such as time, associated service, provider, and product information. The output structure allows downstream nodes or workflows to process or display these available booking times. There is no indication that binary data is returned.

Dependencies

  • Requires an active SimplyBook.me account with API access.
  • Needs an API key credential configured in n8n to authenticate requests.
  • The base URL for API calls is taken from the provided credentials.
  • Uses internal methods to load options dynamically for services, providers, and products.

Troubleshooting

  • Common issues:
    • Missing or invalid API credentials will cause authentication failures.
    • Providing an invalid date format or missing required fields (like date or count) will result in errors.
    • Selecting a service or provider that does not exist or has no available slots may return empty results.
  • Error messages:
    • Authentication errors indicate problems with the API key or permissions.
    • Validation errors point to missing or incorrectly formatted input parameters.
  • Resolutions:
    • Verify API credentials and permissions.
    • Ensure all required properties are set correctly.
    • Confirm that the selected service, provider, and products exist in the SimplyBook.me account.

Links and References

Discussion