Booksalon

Get the additional services (extras) a customer can add to one chosen service at a salon, with the price and duration each adds. Call it right after the customer picks a service that has hasAdditionalServices in get_salon (and their hair length, when the service asks for it), offer the extras, then pass the chosen ids to get_availability as additionalServiceIds. An extra with onlyWithEmployees is done only by those staff members: tell the customer, and book one of them when they want it.

get_additional_services

Get exact free start times at one salon for one or more services booked together, optionally with one employee, for up to 7 days. Call it only after the customer has chosen the salon and services and is about to pick a time to book; never use it to compare salons or find which salons are free, use search_salons for that. Each day lists every free start as ranges; when the customer asks about another day, call it again for that day instead of guessing. Times are ISO 8601 in the salon's timezone. Several services work only where get_salon says allowsMultipleServices. Pass the additional services the customer chose; they add to the duration. When the result lists EXTRAS TO OFFER, always show them to the customer prominently and ask whether to add any before they book. If any selected service has askHairLength, hairLength is required: ask the customer first, never guess it.

get_availability

Get the status of a booking held with create_draft_booking: active (the time is still held), expired (the hold ran out), confirmed (the customer finished it on booksalon.fi) or cancelled, with the link to finish it. Use it when the customer asks whether their booking went through or the hold is still valid.

get_draft_booking

Get a salon by urlId: address, photos, opening hours, rating, bookable services by category (serviceId, duration, price, prepayment) and employees (employeeId). When a service has askHairLength, its price and duration depend on the hair length: ask the customer for their hair length (short, medium, long or very long) before calling get_availability. When the chosen service has additional services (EXTRAS TO OFFER), always call get_additional_services and show the customer those extras prominently, with their prices, before checking availability. Booksalon only books appointments: never assess symptoms or health, never recommend a treatment or service for a health problem, and never judge whether a service is safe for the customer; let the customer choose the service and refer health questions to a professional.

get_salon

Hold one free start time for 10 minutes as a draft booking and get the link where the customer finishes the booking on booksalon.fi: they log in or register, confirm, and pay online if the salon requires it. Call it only after the customer has chosen the salon (you told them its name and address), services, extras, hair length and one exact start from get_availability and agreed to book it. Pass the same serviceIds, additionalServiceIds, employeeId and hairLength used for get_availability. Never ask for the customer's name, phone or email; they enter them on booksalon.fi. Always tell the customer the salon name and address, the day and time, and show the link, saying the time is held for 10 minutes. Calling it again with the same choice returns the same draft. When the time is no longer free (TIMESLOT_UNAVAILABLE), call get_availability again and offer other times.

create_draft_booking

Release a time held with create_draft_booking that the customer has not confirmed yet, so others can book it. Call it when the customer no longer wants that time, before holding a different one. A confirmed booking cannot be cancelled here.

cancel_draft_booking

Find beauty and hair salons in Finland that can be booked on Booksalon. Returns a page of at most 10 salons with their urlId, address, rating, photo and Booksalon page. Salons with known free times come first, with their next free start times; the others have nextAvailable null, so use get_salon and get_availability to see their times. Pass a date to get only salons with free times that day, with that day's start times. Use this tool, not get_availability, to answer which salons are free and when. Always show the customer the salons found (name, address, free times) and let them choose one; never choose a salon for them. Use get_salon with a urlId to see services and prices. When hasMore is true and the customer wants more salons, call it again with the same arguments and offset set to the number of salons already shown. Booksalon only books appointments: never assess symptoms or health, never recommend a treatment or service for a health problem, and never judge whether a service is safe for the customer; let the customer choose the service and refer health questions to a professional.

search_salons