Back to Microsoft Booking
Connect Knoon AI with Microsoft Booking (Microsoft) to automate AI workflows.
Create a new booking appointment (a customer booking) in a booking business.
microsoftBookingCreateAppointment
BETA
Permissions
Optional permissions
There are no items to display.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| businessService | file | Select a service from a business. Contains both businessId and serviceId. | Yes |
| startDateTime | mustache | Appointment start in ISO 8601 (with offset preferred). | Yes |
| endDateTime | mustache | Appointment end in ISO 8601. | Yes |
| customerName | mustache | Customer full name. | Yes |
| customerEmailAddress | mustache | Customer email. | Yes |
| customerPhone | mustache | Optional customer phone. | No |
| customerNotes | mustache | Optional customer notes. | No |
| staffMemberIds | array (mustache) | Optional list of staff member IDs to assign. | No |
| smsNotificationsEnabled | boolean | Enable SMS notifications if business supports it. | No |
| reminderMinutesBeforeStart | number | Email reminder timing in minutes before the appointment starts. Defaults to 1440 (24 hours). Use 60 for 1 hour, 30 for 30 minutes, or 0 for the start time. | No |
| preventConflicts | boolean | If true, backend rejects creation when the requested time overlaps existing non-cancelled appointments in the business. | No |
Returns
| Name | Type | Description |
|---|---|---|
| status | string | CREATED or ERROR. |
| sensitive.appointmentId | string | Appointment ID. |
| sensitive.serviceId | string | Service ID. |
| sensitive.customerName | string | Customer name. |
| sensitive.start | string | Start in ISO 8601. |
| sensitive.end | string | End in ISO 8601. |
| confidential.htmlLink | string | Link to view the appointment if available. |