book_appointment
Schedule an appointment tied to the signed-in customer's account — still a request until the notary confirms it, never guaranteed. PREFER this over request_booking whenever the customer is signed in: only a booking on their own account can later be listed, rescheduled or cancelled through this connector. Guests go through request_booking. Accepts: service (e.g. office, mobile, apostille, loan), scheduled_at — a slot's startUnix from search_availability, omitted for a call-me request — plus address for mobile, notes, document_count. Returns a Pending reference; fails if not signed in.
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": {
"service": "<service>"
},
"name": "book_appointment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Anything else the notary should know. | |
| address | No | Meeting address (required for "mobile"; omit for office/apostille). | |
| service | Yes | Service: office | mobile | apostille | loan. | |
| scheduled_at | No | The chosen slot's `startUnix` (from search_availability). Omit for a "call me to schedule" request (no time held). | |
| document_count | No | Number of documents. Default 1. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| status | No | Account tools: the booking's status after this call (Pending after book_appointment). | |
| message | Yes | Customer-facing outcome; relay it as written — bookings are requests until the notary confirms. | |
| manageUrl | No | Guest requests: the emailed confirm/cancel link, when one was minted (null otherwise). | |
| onAccount | No | True when the request was filed on the signed-in customer's own account — they can then list it with my_bookings and change it with reschedule_booking / cancel_booking. Absent or false means a guest request, managed through the emailed link. | |
| reference | No | Request / order reference for check_request_status (guest tools) or my_bookings (account tools). | |
| appendedToExisting | No | True when existing_reference was given and the request was extended, not duplicated. | |
| ourComparableQuoteCents | No | request_price_match only, when computable. |