Send a booking request
request_bookingSend a Book It business a booking request on a person's behalf. Collects only the person's name, phone, ZIP, what they need and a preferred time. The business receives it by email and in its inbox and confirms a time with the person directly; the request is never a confirmed appointment. Requires consent_confirmed true, which means the person read and agreed to the business's booking_consent_text (from get_services or check_availability). US and Canadian phone numbers only. A repeat request from the same phone to the same business within 24 hours returns the first request instead of sending another.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| need | Yes | What the person needs, in their words, such as "Furnace runs but blows cold air." | |
| service_id | No | Optional service_id from get_services. | |
| business_id | Yes | The business_id exactly as find_provider returned it, such as "juniper-ridge-roofing". | |
| customer_zip | Yes | The 5-digit ZIP where the work is. It must be in the business's service area. | |
| customer_name | Yes | The person's name, at least a first name. | |
| customer_phone | Yes | A US or Canadian phone number the business can call or text, such as (406) 555-0123. | |
| consent_confirmed | Yes | True only after the person read the business's booking_consent_text and agreed to it. | |
| preferred_time_note | No | A short preferred time in words, such as "any weekday morning", when no window fits. | |
| preferred_window_id | No | A window_id from check_availability, such as "2026-10-15@08:00-12:00". |