Booksy US

Build a booking URL from a provider's base URL plus an optional service, date, or time. Pass the provider's base url/booking_url (from search results or get_provider_details) as base_url. With no other arguments this returns it unchanged. Add service_variant_id to open the booking widget on that service — date/time only apply together with it. Add date on top of that to pre-select that day in the widget (the customer picks a time themselves); add time as well (from check_availability) to pre-select the exact slot. Call this only when ready to hand the customer a link — do not pre-build URLs for every option shown.

Check available appointment time slots for a Booksy provider on a specific date. After showing availability, use build_booking_url with the chosen slot's date/time so the user can book the exact time.

List all Booksy business categories. Use when the user asks for a kind of business rather than a specific service (e.g. "barber", "nail salon") — match their wording against the returned names yourself. Each returned item has ``id`` and ``name`` — pass the matching ``id`` as ``category_id`` on search_providers. Use search_service_types instead when the user names a specific service.

Get details for a Booksy provider, including the booking_url the customer uses to book.

Search for hair and beauty providers on Booksy. Returns up to 6 providers. The results are shown to the user in the search_providers_ui widget, with each provider's details and a booking action. Don't list, summarise or repeat the providers in your reply, and don't add your own cards, tables, maps, images or buttons. The booking action already takes the user to Booksy, so only use build_booking_url with a provider's `url` if the user asks for a link.

Resolve a freeform service name to Booksy service type IDs. Use when the user asks for a specific service (e.g. "french manicure", "beard shave"). Each returned item has ``id`` and ``name`` — pass the chosen ``id`` as ``service_type_id`` on search_providers. Use fetch_categories instead when the user names a kind of business rather than a specific service.