bookingService resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents information about a particular service provided by a booking business, such as the service name, price, and the staff that usually provides such service.

Inherits from bookingNamedEntity.

Methods

Method Return Type Description
List services bookingService collection Get a list of bookingService objects in the specified booking business.
Create bookingService bookingService Create a bookingService for the specified booking business.
Get bookingService bookingService Get the properties and relationships of a bookingService object in the specified booking business.
Update None Update a bookingService object in the specified booking business.
Delete None Delete a bookingService object in the specified booking business.

Properties

Property Type Description
additionalInformation String Additional information that is sent to the customer when an appointment is confirmed.
createdDateTime DateTimeOffset The date, time and timezone when the Service was created.
customQuestions bookingQuestionAssignment collection Contains the set of custom questions associated with a particular service.
defaultDuration Duration The default length of the service, represented in numbers of days, hours, minutes, and seconds. For example, P11D23H59M59.999999999999S.
defaultLocation location The default physical location for the service.
defaultPrice Double The default monetary price for the service.
defaultPriceType bookingPriceType The default way the service is charged. Possible values are: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
defaultReminders bookingReminder collection The default set of reminders for an appointment of this service. The value of this property is available only when reading this bookingService by its ID.
description String A text description for the service.
displayName String A service name.
id String The ID of that service, in a GUID format. Read-only.
isAnonymousJoinEnabled Boolean Indicates if an anonymousJoinWebUrl(webrtcUrl) is generated for the appointment booked for this service. The default value is false.
isCustomerAllowedToManageBooking Boolean Indicates that the customer can manage bookings created by the staff. The default value is false.
isHiddenFromCustomers Boolean True means this service isn't available to customers for booking.
isLocationOnline Boolean Indicates that the appointments for the service are held online. The default value is false.
languageTag String The language of the self service booking page.
lastUpdatedDateTime DateTimeOffset The date, time and timezone when the Service was last updated.
maximumAttendeesCount Int32 The maximum number of customers allowed in a service. 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.
notes String Additional information about this service.
postBuffer Duration The time to buffer after an appointment for this service ends, and before the next customer appointment can be booked.
preBuffer Duration The time to buffer before an appointment for this service can start.
schedulingPolicy bookingSchedulingPolicy The set of policies that determine how appointments for this type of service should be created and managed.
smsNotificationsEnabled Boolean True indicates SMS notifications can be sent to the customers for the appointment of the service. Default value is false.
staffMemberIds String collection Represents those staff members who provide this service.
webUrl String The URL a customer uses to access the service.

Relationships

None

JSON representation

Here's a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.bookingService",
  "id": "String (identifier)",
  "displayName": "String",
  "customQuestions": [
    {
      "@odata.type": "microsoft.graph.bookingQuestionAssignment"
    }
  ],
  "defaultDuration": "String (duration)",
  "defaultLocation": {
    "@odata.type": "microsoft.graph.location"
  },
  "defaultPrice": "Double",
  "defaultPriceType": "String",
  "defaultReminders": [
    {
      "@odata.type": "microsoft.graph.bookingReminder"
    }
  ],
  "description": "String",
  "languageTag": "String",
  "isHiddenFromCustomers": "Boolean",
  "notes": "String",
  "additionalInformation": "String",
  "maximumAttendeesCount": "Integer",
  "preBuffer": "String (duration)",
  "postBuffer": "String (duration)",
  "schedulingPolicy": {
    "@odata.type": "microsoft.graph.bookingSchedulingPolicy"
  },
  "staffMemberIds": [
    "String"
  ],
  "isLocationOnline": "Boolean",
  "smsNotificationsEnabled": "Boolean",
  "isAnonymousJoinEnabled": "Boolean",
  "isCustomerAllowedToManageBooking": "Boolean",
  "webUrl": "String",
  "createdDateTime": "String (timestamp)",
  "lastUpdatedDateTime": "String (timestamp)"
}