Back to Microsoft Booking
Microsoft / Microsoft Booking
Search Appointments
Search appointments in a booking business within an optional time window.
microsoftBookingSearchAppointments
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. |
Install In Tools
See how to install an app in your tool
Follow the quick walkthrough below to add marketplace apps into your tool flow.
Step 01
Open your tool setup
Start from the tool workspace where you want to add a new app.
Step 02
Go to tools and create button
Open the Tools page, then click the Create button to start adding a new app.
Step 03
Choose Internal or External work
Choose Internal or External work, then select an app action.
Step 04
Select app to install to Knoon
Pick the app you want to install to Knoon and complete the setup flow.
Step 05
Success!
The app has been installed successfully and is ready to use in your workflow.
Power your business with Knoon's Agentic AI today.
Join businesses already resolving thousands of customer inquiries and sales leads with Knoon.