ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

OnlineMeetings.ReadWrite

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write User Scope

Allows the app to read and create online meetings on behalf of the signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read and create user's online meetings

Allows the app to read and create online meetings on behalf of the signed-in user.

User sees: Allows the app to read and create online meetings on your behalf.
Permission ID: a65f2972-a4f8-4f5e-afd7-69ccb046d5dc

Properties

Microsoft Graph v1.0 mapped-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
allowAttendeeToEnableCamera BooleanNullable Indicates whether attendees can turn on their camera. Inherited from onlineMeetingBase.
allowAttendeeToEnableMic BooleanNullable Indicates whether attendees can turn on their microphone. Inherited from onlineMeetingBase.
allowBreakoutRooms BooleanNullable Indicates whether breakout rooms are enabled for the meeting. Inherited from onlineMeetingBase.
allowCopyingAndSharingMeetingContent BooleanNullable Indicates whether the ability to copy and share meeting content is enabled for the meeting. Inherited from onlineMeetingBase.
allowedLobbyAdmitters allowedLobbyAdmitterRoles Specifies the users who can admit from the lobby. The possible values are: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Inherited from onlineMeetingBase.
allowedPresenters onlineMeetingPresenters Specifies who can be a presenter in a meeting. Possible values are listed in the following table. Inherited from onlineMeetingBase.
allowLiveShare meetingLiveShareOptions Indicates whether live share is enabled for the meeting. The possible values are: enabled, disabled, unknownFutureValue. Inherited from onlineMeetingBase.
allowMeetingChat meetingChatMode Specifies the mode of meeting chat. Inherited from onlineMeetingBase.
allowParticipantsToChangeName BooleanNullable Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from onlineMeetingBase.
allowPowerPointSharing BooleanNullable Indicates whether PowerPoint live is enabled for the meeting. Inherited from onlineMeetingBase.
allowTeamworkReactions BooleanNullable Indicates whether Teams reactions are enabled for the meeting. Inherited from onlineMeetingBase.
allowRecording BooleanNullable Indicates whether recording is enabled for the meeting. Inherited from onlineMeetingBase.
allowTranscription BooleanNullable Indicates whether transcription is enabled for the meeting. Inherited from onlineMeetingBase.
allowWhiteboard BooleanNullable Indicates whether whiteboard is enabled for the meeting. Inherited from onlineMeetingBase.
audioConferencing audioConferencing The phone access (dial-in) information for an online meeting. Read-only. Inherited from onlineMeetingBase.

Showing 15 of 48 properties.

JSON Representation

Microsoft Graph v1.0 mapped-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation 
{
  "allowAttendeeToEnableCamera": "Boolean",
  "allowAttendeeToEnableMic": "Boolean",
  "allowBreakoutRooms": "Boolean",
  "allowCopyingAndSharingMeetingContent": "Boolean",
  "allowedLobbyAdmitters": "String",
  "allowedPresenters": "String",
  "allowLiveShare": "String",
  "allowMeetingChat": "String",
  "allowParticipantsToChangeName": "Boolean",
  "allowPowerPointSharing": "Boolean",
  "allowRecording": "Boolean",
  "allowTeamworkReactions": "Boolean",
  "allowTranscription": "Boolean",
  "allowWhiteboard": "Boolean",
  "attendeeReport": "Stream",
  "audioConferencing": {
    "@odata.type": "microsoft.graph.audioConferencing"
  },
  "broadcastSettings": {
    "@odata.type": "microsoft.graph.broadcastMeetingSettings"
  },
  "chatInfo": {
    "@odata.type": "microsoft.graph.chatInfo"
  },
  "chatRestrictions": {
    "@odata.type": "microsoft.graph.chatRestrictions"
  },
  "creationDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "expiryDateTime": "String (timestamp)",
  "externalId": "String",
  "id": "String (identifier)",
  "isBroadcast": "Boolean",
  "isEndToEndEncryptionEnabled": "Boolean",
  "isEntryExitAnnounced": "Boolean",
  "joinInformation": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "joinMeetingIdSettings": {
    "@odata.type": "microsoft.graph.joinMeetingIdSettings"
  },
  "joinWebUrl": "String",
  "lobbyBypassSettings": {
    "@odata.type": "microsoft.graph.lobbyBypassSettings"
  },
  "meetingOptionsWebUrl": "String",
  "meetingSpokenLanguageTag": "String",
  "meetingTemplateId": "String",
  "participants": {
    "@odata.type": "microsoft.graph.meetingParticipants"
  },
  "recordAutomatically": "Boolean",
  "sensitivityLabelAssignment": {
    "@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"
  },
  "shareMeetingChatHistoryDefault": "String",
  "startDateTime": "String (timestamp)",
  "subject": "String",
  "videoTeleconferenceId": "String",
  "watermarkProtection": "String"
}

Relationships

Microsoft Graph v1.0 mapped-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
attendanceReports meetingAttendanceReport collection The attendance reports of an online meeting. Read-only. Inherited from onlineMeetingBase.
recordings callRecording collection The recordings of an online meeting. Read-only.
transcripts callTranscript collection The transcripts of an online meeting. Read-only.
aiInsights callAiInsight collection The AI insights generated for an online meeting. Read-only.
anonymizeIdentityForRoles array Specifies whose identity is anonymized in the meeting. The possible values are: attendee. The attendee value can't be removed through a PATCH operation once added.
capabilities array The list of meeting capabilities. The possible values are: questionAndAnswer,unknownFutureValue.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /me/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /me/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /me/onlineMeetings/{meetingId}
GET /me/onlineMeetings/{meetingId}/alternativeRecording
GET /me/onlineMeetings/{meetingId}/attendeeReport
GET /me/onlineMeetings/{meetingId}/recording
GET /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /users/{userId}/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /users/{userId}/onlineMeetings/{meetingId}
GET /users/{userId}/onlineMeetings/{meetingId}/alternativeRecording
GET /users/{userId}/onlineMeetings/{meetingId}/attendeeReport
GET /users/{userId}/onlineMeetings/{meetingId}/recording
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
POST /me/onlineMeetings
POST /me/onlineMeetings/createOrGet
POST /users/{userId}/onlineMeetings
POST /users/{userId}/onlineMeetings/createOrGet
PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}
DELETE /me/onlineMeetings/{meetingId}
DELETE /users/{userId}/onlineMeetings/{meetingId}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /app/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /me/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /me/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /me/onlineMeetings/{id}/registration
GET /me/onlineMeetings/{id}/registration/microsoft.graph.meetingRegistration/customQuestions
GET /me/onlineMeetings/{id}/registration/registrants
GET /me/onlineMeetings/{meetingId}
GET /me/onlineMeetings/{meetingId}/alternativeRecording
GET /me/onlineMeetings/{meetingId}/attendeeReport
GET /me/onlineMeetings/{meetingId}/recording
GET /me/onlineMeetings/{meetingId}/registration
GET /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
GET /me/onlineMeetings/{meetingId}/registration/registrants
GET /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
GET /users/{userId}/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /users/{userId}/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /users/{userId}/onlineMeetings/{meetingId}
GET /users/{userId}/onlineMeetings/{meetingId}/alternativeRecording
GET /users/{userId}/onlineMeetings/{meetingId}/attendeeReport
GET /users/{userId}/onlineMeetings/{meetingId}/recording
GET /users/{userId}/onlineMeetings/{meetingId}/registration
GET /users/{userId}/onlineMeetings/{meetingId}/registration/registrants
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
POST /me/onlineMeetings
POST /me/onlineMeetings/{id}/registration
POST /me/onlineMeetings/{id}/registration/microsoft.graph.meetingRegistration/customQuestions
POST /me/onlineMeetings/{meetingId}/registration
POST /me/onlineMeetings/{meetingId}/registration/registrants
POST /me/onlineMeetings/createOrGet
POST /users/{userId}/onlineMeetings
POST /users/{userId}/onlineMeetings/{id}/registration/registrants
POST /users/{userId}/onlineMeetings/{meetingId}/registration
POST /users/{userId}/onlineMeetings/{meetingId}/registration/registrants
POST /users/{userId}/onlineMeetings/createOrGet
PATCH /me/onlineMeetings/{id}/registration
PATCH /me/onlineMeetings/{meetingId}
PATCH /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
PATCH /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
PATCH /users/{userId}/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
PUT /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
PUT /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
DELETE /me/onlineMeetings/{id}/registration
DELETE /me/onlineMeetings/{meetingId}
DELETE /me/onlineMeetings/{meetingId}/registration
DELETE /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
DELETE /me/onlineMeetings/{meetingId}/registration/registrants/{registrantId}
DELETE /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
DELETE /users/{userId}/onlineMeetings/{meetingId}
DELETE /users/{userId}/onlineMeetings/{meetingId}/registration
DELETE /users/{userId}/onlineMeetings/{meetingId}/registration/registrants/{id}
DELETE /users/{userId}/onlineMeetings/{meetingId}/registration/registrants/{registrantId}
DELETE /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgCommunicationOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeetingAttendeeReport /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeetingVirtualAppointmentJoinWebUrl /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
virtualAppointment: getVirtualAppointmentJoinWebUrl
New-MgUserOnlineMeeting /me/onlineMeetings
Create onlineMeeting
Remove-MgUserOnlineMeeting /me/onlineMeetings/{meetingId}
Delete onlineMeeting
Update-MgUserOnlineMeeting /me/onlineMeetings/{meetingId}
Update onlineMeeting
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaCommunicationOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingAttendeeReport /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingRecording /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{id}/registration
Get meetingRegistration
Get-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{meetingId}/registration
Get externalMeetingRegistration
Get-MgBetaUserOnlineMeetingRegistrationCustomQuestion /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
Get customRegistrationQuestion
Get-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{id}/registration/registrants
List registrants
Get-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{meetingId}/registration/registrants
List externalMeetingRegistrants
Get-MgBetaUserOnlineMeetingVirtualAppointmentJoinWebUrl /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
virtualAppointment: getVirtualAppointmentJoinWebUrl
New-MgBetaUserOnlineMeeting /me/onlineMeetings
Create onlineMeeting
New-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{meetingId}/registration/registrants
Create externalMeetingRegistrant
New-MgBetaUserOnlineMeetingRegistrationRegistrant /users/{userId}/onlineMeetings/{id}/registration/registrants
Create meetingRegistrant
Remove-MgBetaUserOnlineMeeting /me/onlineMeetings/{meetingId}
Delete onlineMeeting
Remove-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{id}/registration
Delete meetingRegistration
Remove-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{meetingId}/registration
Delete externalMeetingRegistration
Remove-MgBetaUserOnlineMeetingRegistrationCustomQuestion /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
Delete meetingRegistrationQuestion
Remove-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{meetingId}/registration/registrants/{registrantId}
Delete externalMeetingRegistrant
Remove-MgBetaUserOnlineMeetingRegistrationRegistrant /users/{userId}/onlineMeetings/{meetingId}/registration/registrants/{id}
Delete meetingRegistrant
Update-MgBetaUserOnlineMeeting /me/onlineMeetings/{meetingId}
Update onlineMeeting
Update-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{id}/registration
Update meetingRegistration
Update-MgBetaUserOnlineMeetingRegistrationCustomQuestion /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
Update meetingRegistrationQuestion

Code Examples

C# / .NET SDK
Create onlineMeeting
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new OnlineMeeting
{
	StartDateTime = DateTimeOffset.Parse("2019-07-12T14:30:34.2444915-07:00"),
	EndDateTime = DateTimeOffset.Parse("2019-07-12T15:00:34.2464912-07:00"),
	Subject = "User Token Meeting",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.OnlineMeetings.PostAsync(requestBody);
JavaScript
Create onlineMeeting
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

const onlineMeeting = {
  startDateTime: '2019-07-12T14:30:34.2444915-07:00',
  endDateTime: '2019-07-12T15:00:34.2464912-07:00',
  subject: 'User Token Meeting'
};

await client.api('/me/onlineMeetings')
	.post(onlineMeeting);
PowerShell
Create onlineMeeting
View official example on Microsoft Learn
Import-Module Microsoft.Graph.CloudCommunications

$params = @{
	startDateTime = [System.DateTime]::Parse("2019-07-12T14:30:34.2444915-07:00")
	endDateTime = [System.DateTime]::Parse("2019-07-12T15:00:34.2464912-07:00")
	subject = "User Token Meeting"
}
# A UPN can also be used as -UserId.
New-MgUserOnlineMeeting -UserId $userId -BodyParameter $params
Python
Create onlineMeeting
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.online_meeting import OnlineMeeting
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = OnlineMeeting(
	start_date_time = "2019-07-12T14:30:34.2444915-07:00",
	end_date_time = "2019-07-12T15:00:34.2464912-07:00",
	subject = "User Token Meeting",
)

result = await graph_client.me.online_meetings.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for OnlineMeetings.ReadWrite

4

Grant Admin Consent

Users can consent to this permission during sign-in.