Back to Microsoft Booking
Connect Knoon AI with Microsoft Booking (Microsoft) to automate AI workflows.
Search appointments in a booking business within an optional time window.
microsoftBookingSearchAppointments
BETA
Permissions
Optional permissions
There are no items to display.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| businessId | file | Booking business to use (select from your connected Microsoft Bookings businesses). | Yes |
| start | mustache | Inclusive lower bound for appointment start in ISO 8601. | Yes |
| end | mustache | Exclusive upper bound for appointment end in ISO 8601. | Yes |
| customerEmail | mustache | Optional customer email to filter appointments. Matches the primary customer on the appointment. | No |
| maxResults | mustache | Maximum number of appointments to return. | No |
Returns
| Name | Type | Description |
|---|---|---|
| status | string | DONE. |
| appointments.start | string | Start date/time in ISO 8601. |
| appointments.end | string | End date/time in ISO 8601. |
| appointments.startDayOfWeekLocal | string | Day of week of the appointment start in local time (e.g. "Monday"). |
| appointments.startDayOfWeekUTC | string | Day of week of the appointment start in UTC (e.g. "Monday"). |
| appointments.endDayOfWeekLocal | string | Day of week of the appointment end in local time. |
| appointments.endDayOfWeekUTC | string | Day of week of the appointment end in UTC. |
| appointments.sensitive.appointmentId | string | Appointment ID. |
| appointments.sensitive.serviceId | string | Service ID. |
| appointments.sensitive.serviceName | string | Service name. |
| appointments.sensitive.customerName | string | Customer name. |
| appointments.sensitive.staffMemberIds | array | Assigned staff member IDs. |
| appointments.sensitive.isCancelled | boolean | Whether cancelled. |
| appointments.confidential.htmlLink | string | Link to view the appointment if available. |