onlineMeeting resource type

Namespace: microsoft.graph

Contains information about a meeting, including the URL used to join a meeting, the attendees list, and the description.


Method Return Type Description
Create onlineMeeting onlineMeeting Create an online meeting.
Get onlineMeeting onlineMeeting Read the properties and relationships of an onlineMeeting object.
Update onlineMeeting Update the properties of an onlineMeeting object.
Delete onlineMeeting None Delete an onlineMeeting object.
Create or get onlineMeeting onlineMeeting Create an onlineMeeting object with a custom, external ID. If the meeting already exists, retrieve its properties.


Property Type Description
allowAttendeeToEnableCamera Boolean Indicates whether attendees can turn on their camera.
allowAttendeeToEnableMic Boolean Indicates whether attendees can turn on their microphone.
allowedPresenters onlineMeetingPresenters Specifies who can be a presenter in a meeting. Possible values are listed in the following table.
allowMeetingChat meetingChatMode Specifies the mode of meeting chat.
allowTeamworkReactions Boolean Indicates whether Teams reactions are enabled for the meeting.
attendeeReport Stream The content stream of the attendee report of a Microsoft Teams live event. Read-only.
audioConferencing audioConferencing The phone access (dial-in) information for an online meeting. Read-only.
broadcastSettings broadcastMeetingSettings Settings related to a live event.
chatInfo chatInfo The chat information associated with this online meeting.
creationDateTime DateTime The meeting creation time in UTC. Read-only.
endDateTime DateTime The meeting end time in UTC.
id String The default ID associated with the online meeting. Read-only.
isBroadcast Boolean Indicates if this is a Teams live event.
isEntryExitAnnounced Boolean Indicates whether to announce when callers join or leave.
joinInformation itemBody The join information in the language and locale variant specified in the Accept-Language request HTTP header. Read-only.
joinMeetingIdSettings joinMeetingIdSettings Specifies the joinMeetingId, the meeting passcode, and the requirement for the passcode. Once an onlineMeeting is created, the joinMeetingIdSettings cannot be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created.
joinWebUrl String The join URL of the online meeting. Read-only.
lobbyBypassSettings lobbyBypassSettings Specifies which participants can bypass the meeting lobby.
participants meetingParticipants The participants associated with the online meeting. This includes the organizer and the attendees.
recordAutomatically Boolean Indicates whether to record the meeting automatically.
startDateTime DateTime The meeting start time in UTC.
subject String The subject of the online meeting.
videoTeleconferenceId String The video teleconferencing ID. Read-only.
watermarkProtection watermarkProtectionValues Specifies whether a watermark should be applied to a content type by the client application.

onlineMeetingPresenters values

Value Description
everyone Everyone is a presenter (This is default option).
organization Everyone in organizer’s organization is a presenter.
roleIsPresenter Only the participants whose role is presenter are presenters.
organizer Only the organizer is a presenter.
unknownFutureValue Evolvable enumeration sentinel value. Do not use.


When creating or updating an online meeting with allowedPresenters set to roleIsPresenter, include a full list of attendees with the specified attendees' role set to presenter in the request body.

meetingChatMode values

Value Description
enabled Meeting chat is enabled.
disabled Meeting chat is disabled.
limited Meeting chat is enabled but only for the duration of the meeting call.
unknownFutureValue Evolvable enumeration sentinel value. Do not use.


Relationship Type Description
attendanceReports meetingAttendanceReport collection The attendance reports of an online meeting. Read-only.

JSON representation

  "allowAttendeeToEnableCamera": "Boolean",
  "allowAttendeeToEnableMic": "Boolean",
  "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"},
  "allowTeamworkReactions": "Boolean",
  "allowedPresenters": "String",
  "attendeeReport": "Stream",
  "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
  "broadcastSettings": {"@odata.type": "microsoft.graph.broadcastSettings"},
  "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
  "creationDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "isBroadcast": "Boolean",
  "isEntryExitAnnounced": "Boolean",
  "joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
  "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
  "joinWebUrl": "String",
  "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
  "participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
  "recordAutomatically": "Boolean",
  "startDateTime": "String (timestamp)",
  "subject": "String",
  "videoTeleconferenceId": "String",