Easy!Appointments icon

Easy!Appointments

Interact with Easy!Appointments API
Join our community

Actions21

Overview

This node integrates with the Easy!Appointments API to retrieve availability information for service providers. Specifically, the "Availability" resource with the "Get" operation allows users to fetch available time slots based on a provider, a service, and a specific date. This is useful in scheduling workflows where you want to check when a provider is free to accept appointments for a given service on a particular day.

Common scenarios:

  • Automatically checking provider availability before booking an appointment.
  • Displaying available time slots to customers in a booking form.
  • Synchronizing availability data with other calendar or scheduling systems.

Example:
You want to find all available times for Provider ID 5 offering Service ID 10 on July 1st, 2024. The node will query the Easy!Appointments API and return the list of available slots for that day.

Properties

Name Meaning
Provider ID The numeric ID of the provider whose availabilities you want to retrieve.
Service ID The numeric ID of the service for which you want to get availabilities.
Date The specific date (including time) to check availabilities for.

Output

The output is a JSON array containing availability objects returned by the Easy!Appointments API. Each object represents an available time slot or availability entry for the specified provider, service, and date.

  • The exact structure depends on the API response but typically includes fields such as start time, end time, and possibly additional metadata about the availability.
  • No binary data is output by this node.

Dependencies

  • Requires an active connection to the Easy!Appointments API.
  • Needs an API authentication credential configured in n8n (referred generically as an API key or token).
  • The base URL for the Easy!Appointments instance must be set in the credentials configuration.

Troubleshooting

  • Invalid or missing credentials: Ensure the API key/token and base URL are correctly configured in the node's credentials.
  • Provider or Service ID not found: Verify that the IDs used exist in your Easy!Appointments system.
  • Date format issues: The date property should be a valid ISO 8601 datetime string; incorrect formats may cause errors.
  • API request failures: Network issues or API downtime can cause errors; check connectivity and API status.
  • Empty results: If no availabilities are returned, confirm that the provider offers the service on the specified date and that there are open slots.

Links and References

Discussion