ESC
Type to search...

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.

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.

Relationships

Relationship Type Description
attendanceReports meetingAttendanceReport collection The attendance reports of an online meeting. Read-only.
attendeeReport Stream The content stream of the attendee report of a Microsoft Teams live event. Read-only.
recordings callRecording collection The recordings of an online meeting. Read-only.
transcripts callTranscript collection The transcripts of an online meeting. Read-only.

Graph Methods

Delegated access App-only access
Methods
GET /me/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /me/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /me/onlineMeetings/{meetingId}
GET /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
POST /me/onlineMeetings
POST /me/onlineMeetings/createOrGet
PATCH /me/onlineMeetings/{meetingId}
DELETE /me/onlineMeetings/{meetingId}
Methods
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}/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/{meetingId}/registration
GET /users/{userId}/onlineMeetings/{meetingId}/registration/registrants
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
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/{id}/registration/registrants
POST /users/{userId}/onlineMeetings/{meetingId}/registration
POST /users/{userId}/onlineMeetings/{meetingId}/registration/registrants
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/{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}/registration
DELETE /users/{userId}/onlineMeetings/{meetingId}/registration/registrants/{id}
DELETE /users/{userId}/onlineMeetings/{meetingId}/registration/registrants/{registrantId}
DELETE /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment

No PowerShell cmdlets available for this version.

Code Examples

C# / .NET SDK
// Install: dotnet add package Microsoft.Graph
// Install: dotnet add package Azure.Identity
using Microsoft.Graph;
using Azure.Identity;

// Delegated permissions - interactive user sign-in
var scopes = new[] { "OnlineMeetings.ReadWrite" };
var options = new InteractiveBrowserCredentialOptions
{
    ClientId = "YOUR_CLIENT_ID",
    TenantId = "YOUR_TENANT_ID",
    RedirectUri = new Uri("http://localhost")
};
var credential = new InteractiveBrowserCredential(options);
var graphClient = new GraphServiceClient(credential, scopes);

// Example: GET /me
var result = await graphClient.Me.GetAsync();
Console.WriteLine($"User: {result?.DisplayName}");
JavaScript / TypeScript
// npm install @azure/msal-browser @microsoft/microsoft-graph-client
import { PublicClientApplication } from "@azure/msal-browser";
import { Client } from "@microsoft/microsoft-graph-client";
import { AuthCodeMSALBrowserAuthenticationProvider } from 
    "@microsoft/microsoft-graph-client/authProviders/authCodeMsalBrowser";

const msalConfig = {
    auth: {
        clientId: "YOUR_CLIENT_ID",
        authority: "https://login.microsoftonline.com/YOUR_TENANT_ID"
    }
};

const pca = new PublicClientApplication(msalConfig);
await pca.initialize();

// Delegated: Login with required scope
const loginResponse = await pca.loginPopup({
    scopes: ["OnlineMeetings.ReadWrite"]
});

const authProvider = new AuthCodeMSALBrowserAuthenticationProvider(pca, {
    account: loginResponse.account,
    scopes: ["OnlineMeetings.ReadWrite"],
    interactionType: "popup"
});

const graphClient = Client.initWithMiddleware({ authProvider });

// Example: GET /me
const result = await graphClient.api("/me").get();
console.log(result);
PowerShell
# Install Microsoft Graph PowerShell module
Install-Module Microsoft.Graph -Scope CurrentUser

# Delegated access - interactive sign-in
Connect-MgGraph -Scopes "OnlineMeetings.ReadWrite"

# Verify connection
Get-MgContext | Select-Object Account, TenantId, Scopes

# Example: GET /me
$result = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/me"
$result | ConvertTo-Json -Depth 5


# Always disconnect when done
Disconnect-MgGraph
Python
# pip install msgraph-sdk azure-identity
from azure.identity import InteractiveBrowserCredential, ClientSecretCredential
from msgraph import GraphServiceClient
import asyncio

# Delegated permissions - interactive browser sign-in
credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)
scopes = ["OnlineMeetings.ReadWrite"]
client = GraphServiceClient(credential, scopes)

async def get_data():
    # Example: GET /me
    result = await client.me.get()
    print(f"User: {result.display_name}")
    return result

asyncio.run(get_data())

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 themselves during sign-in.