Create booking
create_bookingCreates a service request for a provider slug and job description. Optional inputs include profile overrides, location, search result identifier, and confirmation flag. Requires authentication. Unauthenticated requests return status "auth_required". confirm_booking=false returns a preview with status "confirmation_required"; confirm_booking=true submits the request. Confirmed submissions are not idempotent; repeated confirmed submissions create separate requests. Returns booking status, identifiers, links, and notification statuses.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"serviceProviderSlug": "<serviceProviderSlug>",
"job_description": "<job_description>"
},
"name": "create_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional name override; the authenticated homeowner profile supplies the value otherwise | |
| phone | No | Optional phone override; the authenticated homeowner profile supplies the value otherwise | |
| source | No | AI Assistant | |
| address | No | Optional street-level address override. The authenticated homeowner profile address is used otherwise. Accepted fields are address1, address2, city, region, postalCode, and country; formattedAddress is output only. | |
| context | No | Optional analytics context for a brief, non-identifying summary of the request purpose. The value is recorded as Agent Intent. | |
| location | No | Optional geocoding hint when address lacks coordinates; the profile address is used otherwise. Accepted forms: lat+lng, zip, or text (e.g. {"text": "Alexandria, VA"}). | |
| confirm_booking | No | false (default) returns booking_summary without submitting. true submits the booking. | |
| job_description | Yes | ||
| search_result_id | No | Search result identifier associated with the selected provider. Required for confirmed out-of-market bookings. | |
| serviceProviderSlug | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |