Calendar.ReadWrite
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Application Permission
|
|
Id |
|
Display String |
|
Description |
|
Resources
Property |
Type |
Description |
additionalInformation |
String |
Additional information that is sent to the customer when an appointment is confirmed. |
anonymousJoinWebUrl |
String |
The URL of the meeting to join anonymously. |
customers |
bookingCustomerInformation collection |
A collection of customer properties for an appointment. An appointment contains a list of customer information and each unit will indicate the properties of a customer who is part of that appointment. Optional. |
customerTimeZone |
String |
The time zone of the customer. For a list of possible values, see dateTimeTimeZone. |
duration |
Duration |
The length of the appointment, denoted in ISO8601 format. |
endDateTime |
dateTimeTimeZone |
The date, time, and time zone that the appointment ends. |
filledAttendeesCount |
Int32 |
The current number of customers in the appointment |
id |
String |
The ID of the bookingAppointment. Read-only. |
isLocationOnline |
Boolean |
If true , indicates that the appointment will be held online. Default value is false . |
joinWebUrl |
String |
The URL of the online meeting for the appointment. |
maximumAttendeesCount |
Int32 |
The maximum number of customers allowed in an appointment. If maximumAttendeesCount of the service is greater than 1, pass valid customer IDs while creating or updating an appointment. To create a customer, use the Create bookingCustomer operation. |
optOutOfCustomerEmail |
Boolean |
If true indicates that the bookingCustomer for this appointment doesn't wish to receive a confirmation for this appointment. |
postBuffer |
Duration |
The amount of time to reserve after the appointment ends, for cleaning up, as an example. The value is expressed in ISO8601 format. |
preBuffer |
Duration |
The amount of time to reserve before the appointment begins, for preparation, as an example. The value is expressed in ISO8601 format. |
price |
Double |
The regular price for an appointment for the specified bookingService. |
priceType |
bookingPriceType |
A setting to provide flexibility for the pricing structure of services. Possible values are: undefined , fixedPrice , startingAt , hourly , free , priceVaries , callUs , notSet , unknownFutureValue . |
reminders |
bookingReminder collection |
The collection of customer reminders sent for this appointment. The value of this property is available only when reading this bookingAppointment by its ID. |
selfServiceAppointmentId |
String |
An additional tracking ID for the appointment, if the appointment has been created directly by the customer on the scheduling page, as opposed to by a staff member on the behalf of the customer. Only supported for appointment if maxAttendeeCount is 1. |
serviceId |
String |
The ID of the bookingService associated with this appointment. |
serviceLocation |
location |
The location where the service is delivered. |
serviceName |
String |
The name of the bookingService associated with this appointment. This property is optional when creating a new appointment. If not specified, it's computed from the service associated with the appointment by the serviceId property. |
serviceNotes |
String |
Notes from a bookingStaffMember. The value of this property is available only when reading this bookingAppointment by its ID. |
smsNotificationsEnabled |
Boolean |
If true , indicates SMS notifications will be sent to the customers for the appointment. Default value is false . |
staffMemberIds |
String collection |
The ID of each bookingStaffMember who is scheduled in this appointment. |
startDateTime |
dateTimeTimeZone |
The date, time, and time zone that the appointment begins. |
Property |
Type |
Description |
availabilityIsAffectedByPersonalCalendar |
Boolean |
True means that if the staff member is a Microsoft 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Microsoft 365, before making a booking. |
displayName |
String |
The name of the staff member, as displayed to customers. Required. |
emailAddress |
String |
The email address of the staff member. This can be in the same Microsoft 365 tenant as the business, or in a different email domain. This email address can be used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business. Required. |
id |
String |
The ID of the staff member, in a GUID format. Read-only. |
isEmailNotificationEnabled |
Boolean |
True indicates that a staff member will be notified via email when a booking assigned to them is created or changed. |
role |
bookingStaffRole |
The role of the staff member in the business. Possible values are: guest , administrator , viewer , externalGuest , unknownFutureValue , scheduler , teamMember . Note that you must use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: scheduler , teamMember . Required. |
timeZone |
String |
The time zone of the staff member. For a list of possible values, see dateTimeTimeZone. |
useBusinessHours |
Boolean |
True means the staff member's availability is as specified in the businessHours property of the business. False means the availability is determined by the staff member's workingHours property setting. |
workingHours |
bookingWorkHours collection |
The range of hours each day of the week that the staff member is available for booking. By default, they are initialized to be the same as the **b |
Property |
Type |
Description |
availabilityItems |
availabilityItem collection |
Each item in this collection indicates a slot and the status of the staff member. |
staffId |
String |
The ID of the staff member. |