Block Booking icon

Block Booking

Book appointments and check availability using the Block API
Join our community

Actions2

Overview

This node interacts with the Block API to retrieve available appointment slots within a specified date range. It is useful for scheduling systems where users need to find open time slots for appointments with specific service providers or across all providers. For example, a business can use this node to show customers available booking times for a particular service provider or for the entire team during business hours.

Use Case Examples

  1. Retrieve available appointment slots for a specific provider between two dates.
  2. Get all available appointment slots across all providers within a date range, respecting business hours constraints.

Properties

Name Meaning
Connection ID ID of the connection to the booking platform, used to identify which booking system to query.
Start Date Start of the availability search window in ISO 8601 format, including timezone information.
End Date End of the availability search window in ISO 8601 format, including timezone information.
Provider Name or identifier of the service provider to check availability for. If omitted, availability is aggregated across all providers.
Duration (Minutes) Desired appointment duration in minutes to filter available slots accordingly.
Business Hours Optional business hours constraint specifying start and end times to limit availability search within these hours.
Poll Interval (Seconds) Frequency in seconds to poll for job completion when retrieving availability.
Poll Timeout (Seconds) Maximum time in seconds to wait for job completion before timing out.

Output

JSON

  • availabilitySlots - List of available appointment time slots returned by the Block API within the specified date range and constraints.

Dependencies

  • Block API

Troubleshooting

  • Ensure the Connection ID is valid and has proper access to the booking platform.
  • Verify that the Start Date and End Date are in correct ISO 8601 format with timezone information.
  • If polling times out, consider increasing the Poll Timeout or checking the booking platform's job processing status.
  • If no availability is returned, check if the provider name is correct or if business hours constraints are too restrictive.

Links

Discussion