virtualAppointment resource type (deprecated)

Namespace: microsoft.graph


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.


The Virtual appointment resource and supporting methods are deprecated and will stop returning data on June 30, 2023. We recommend that you update existing apps that use this API to the new Get Virtual appointment join link function.

Represents information about a virtual appointment, including the client join URL, settings, and the client information. Virtual appointments are designed for business to consume online workflows and include enhanced features such as mobile browser join and client waiting room.


For the preview period, customers with access to virtual appointments with their Microsoft 365 licenses benefit from unlimited virtual appointment calls via the Microsoft Graph API. We'll provide additional details on the licensing requirements before the preview period ends.


Method Return type Description
Create virtualAppointment virtualAppointment Create a new virtualAppointment object.
Get virtualAppointment virtualAppointment Read the properties and relationships of a virtualAppointment object.
Update virtualAppointment None Update the properties of a virtualAppointment object.
Delete virtualAppointment None Delete a virtualAppointment object.


When you create a virtual appointment resource for the first time in a tenant, the request returns a 409 Conflict response code with a retry header that indicates how long a caller should wait before making the request again. The service provisioning takes less than five minutes. This step is only required once per customer tenant.


Property Type Description
appointmentClients virtualAppointmentUser collection The client information for the virtual appointment, including name, email, and SMS phone number. Optional.
appointmentClientJoinWebUrl String The join web URL of the virtual appointment for clients with waiting room and browser join. Optional.
externalAppointmentId String The identifier of the appointment from the scheduling system, associated with the current virtual appointment. Optional.
externalAppointmentUrl String The URL of the appointment resource from the scheduling system, associated with the current virtual appointment. Optional.
settings virtualAppointmentSettings The settings associated with the virtual appointment resource. Optional.



JSON representation

The following is a JSON representation of the resource.

    "@odata.type": "#microsoft.graph.virtualAppointment",
    "appointmentClients": [
            "@odata.type": "microsoft.graph.virtualAppointmentUser"
    "appointmentClientJoinWebUrl": "String",
    "externalAppointmentId": "String",
    "externalAppointmentUrl": "String",
    "id": "String (identifier)",
    "settings": {
        "@odata.type": "microsoft.graph.virtualAppointmentSettings"