beautygo_available_slots
ChatGPTLists the FREE appointment slots of a provider, for ONE day (date=YYYY-MM-DD) or a RANGE (from and to, 31 days max). Requires the provider id (stylist_id, returned by beautygo_find_providers). Passing service_id (from beautygo_list_provider_services) sizes the slots to the real duration of that service. Each slot has a slot_id (opaque and stable), the local time AT THE VENUE and a timezone-aware ISO 8601 timestamp. Call it BEFORE beautygo_book_appointment or beautygo_reschedule_appointment so that you only offer times that are actually free. Availability is not guaranteed and is checked again when booking.
beautygo_book_appointment
ChatGPTPREVIEW FIRST: without confirm: true this call only returns a preview and changes nothing. Call it again with confirm: true only after the user has explicitly approved that preview. Books a beauty appointment for the signed-in user, never for someone else. Requires the provider id (stylist_id, from beautygo_search_services or beautygo_find_providers) and the requested date and time (requested_datetime, ISO 8601). Provide service_id (from beautygo_list_provider_services) unless it is a free-form request. DEPOSIT: services that require a deposit (deposit_required in beautygo_list_provider_services) cannot be booked here; the call is refused, nothing is created, and the user books them in the BeautyGo app. Otherwise the request is sent to the provider (status: pending) and waits for the provider to accept. This tool never charges the user and never returns a payment link. Each confirmed call creates a new request, so never repeat a confirmed call.
beautygo_cancel_appointment
ChatGPTPREVIEW FIRST: without confirm: true this call only returns a preview and changes nothing. Call it again with confirm: true only after the user has explicitly approved that preview. Cancels a booking of the signed-in user. IRREVERSIBLE. Depending on the cancellation policy of the provider, any deposit is released (if it was only authorized on the card), refunded (if it was charged) or kept (late cancellation); a reputation penalty may apply, and cancelling within 48 hours of a confirmed appointment may be refused (it then needs the provider to agree). Always show these consequences in the preview before confirming.
beautygo_find_providers
ChatGPTMain entry point to find beauty PROVIDERS (a person or a salon) by city or by name. Use it as soon as the user asks for people: who does braids in Antibes, a hairdresser in Nice, a barber nearby, or a provider by name. Put a city name in the city parameter, never in the free text of beautygo_search_services, which has no city field and would return an empty list. Returns for each provider its id, its @handle, its city and the link to its public profile. Pass the id to beautygo_list_provider_services or beautygo_provider_rating. total is the real number of matches and returned is how many are included.
beautygo_get_provider
ChatGPTFull public profile of a provider from its id (the stylist_id returned by beautygo_search_services, or the id returned by beautygo_find_providers): name, city, bio, photo, average rating, verification level, and profile_url, the link to give to the user to book on BeautyGo.
beautygo_get_provider_by_handle
ChatGPTSame public profile, looked up by @handle (for example lashesbymarthe). Use it when the user mentions a handle or pastes a link such as beautygo.fr/@someone.
beautygo_list_provider_services
ChatGPTAll services offered by ONE provider, with their prices and durations. Call it after beautygo_search_services or beautygo_find_providers to answer what a provider offers and at what price.
beautygo_my_bookings
ChatGPTAppointment history of the signed-in user, grouped by status (upcoming, past, cancelled). Use it for questions like which provider did I see last time or when did I last get braids, or to book again with a provider already seen. Requires the user to sign in.
beautygo_my_upcoming_bookings
ChatGPTUpcoming beauty appointments of the signed-in user, with date, service and provider. Use it for questions like what is my next appointment, what do I have on Thursday, or do I have anything planned. Requires the user to sign in.
beautygo_provider_rating
ChatGPTAverage rating, total number of reviews and breakdown by star for a provider. Cheap: prefer it over beautygo_provider_reviews when only the rating matters.
beautygo_provider_reviews
ChatGPTReviews left by the clients of a provider, with their comments. Use it when the user asks what people think of a provider, not only the rating.
beautygo_reschedule_appointment
ChatGPTPREVIEW FIRST: without confirm: true this call only returns a preview and changes nothing. Call it again with confirm: true only after the user has explicitly approved that preview. Requests a new date and time (new_datetime, ISO 8601) for an existing booking of the signed-in user. Check the slot first with beautygo_available_slots. Rules enforced by the server: a request that is still pending moves directly to the new date; an appointment that is ALREADY CONFIRMED does not move unilaterally, the new date is PROPOSED to the provider and only applies once the provider accepts; within 48 hours of a confirmed appointment the change is refused (reschedule_within_48h) and can only be negotiated with the provider in the BeautyGo app. Any deposit stays attached to the appointment. The response says whether the new date is applied (date_appliquee): never present a PROPOSED date as final.
beautygo_search_services
ChatGPTSearches the SERVICE catalog (hair, barber, lashes and brows, body care) by free text (for example braids or laser hair removal), by category, by price range, or around a place (lat/lng). A CITY name is NOT a criterion here, there is no city field: to find a provider in Antibes or a hairdresser in Nice, or to look someone up by city or by name, use beautygo_find_providers instead, otherwise the city ends up as free text and the list comes back empty. Each result carries a stylist_id: pass it to beautygo_list_provider_services for the detailed service list, or, once the user is signed in, to beautygo_book_appointment to book.
beautygo_service_categories
ChatGPTLists the service categories that exist on BeautyGo. Call it BEFORE beautygo_search_services when unsure about the category value: an invented category returns an empty list, which would wrongly suggest that nobody offers the service.