VirtualEvent.ReadWrite
Allows the app to read and write virtual events for you
Permission Details
Read and write your virtual events
Allows the app to read and write virtual events for you
d38d189c-e29b-4344-8b3b-829bfa81380b
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
createdBy |
communicationsIdentitySet |
The identity information for the creator of the virtual event. Inherited from virtualEvent. |
description |
itemBody |
A description of the virtual event. |
displayName |
StringNullable |
The display name of the virtual event. |
endDateTime |
dateTimeTimeZone |
The end time of the virtual event. The timeZone property can be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see Get-TimeZone. |
externalEventInformation |
virtualEventExternalInformation collection |
The external information of a virtual event. Returned only for event organizers or coorganizers; otherwise, null. |
id |
String |
The unique identifier of the virtual event. Inherited from entity. |
settings |
virtualEventSettings |
The virtual event settings. |
startDateTime |
dateTimeTimeZone |
Start time of the virtual event. The timeZone property can be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see Get-TimeZone. |
status |
virtualEventStatus |
The status of the virtual event. The possible values are: draft, published, canceled, and unknownFutureValue. |
presenters |
virtualEventPresenter collection |
The virtual event presenters. |
sessions |
virtualEventSession collection |
The sessions for the virtual event. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@odata.type": "#microsoft.graph.virtualEvent",
"createdBy": {
"@odata.type": "microsoft.graph.communicationsIdentitySet"
},
"description": {
"@odata.type": "microsoft.graph.itemBody"
},
"displayName": "String",
"endDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"externalEventInformation": [
{
"@odata.type": "microsoft.graph.virtualEventExternalInformation"
}
],
"id": "String (identifier)",
"settings": {
"@odata.type": "microsoft.graph.virtualEventSettings"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String"
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
presenters |
virtualEventPresenter collection |
The virtual event presenters. |
sessions |
virtualEventSession collection |
The sessions for the virtual event. |
events |
virtualEvent collection |
Virtual events in the tenant. |
townhalls |
virtualEventTownhall collection |
Virtual event town halls. |
webinars |
virtualEventWebinar collection |
Virtual event webinars. |
externalEventInformation |
virtualEventExternalInformation collection |
The external information of a virtual event. Returned only for event organizers or coorganizers; otherwise, null. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new VirtualEventPresenter
{
Identity = new CommunicationsUserIdentity
{
OdataType = "#microsoft.graph.communicationsUserIdentity",
Id = "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.VirtualEvents.Webinars["{virtualEventWebinar-id}"].Presenters.PostAsync(requestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const virtualEventPresenter = {
identity: {
'@odata.type': '#microsoft.graph.communicationsUserIdentity',
id: '7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b'
}
};
await client.api('/solutions/virtualEvents/webinars/6b48b5dd-e3a0-428c-b7ad-90896b87a047@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters')
.post(virtualEventPresenter);
Import-Module Microsoft.Graph.Bookings
$params = @{
identity = @{
"@odata.type" = "#microsoft.graph.communicationsUserIdentity"
id = "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b"
}
}
New-MgVirtualEventWebinarPresenter -VirtualEventWebinarId $virtualEventWebinarId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.virtual_event_presenter import VirtualEventPresenter
from msgraph.generated.models.communications_user_identity import CommunicationsUserIdentity
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = VirtualEventPresenter(
identity = CommunicationsUserIdentity(
odata_type = "#microsoft.graph.communicationsUserIdentity",
id = "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
),
)
result = await graph_client.solutions.virtual_events.webinars.by_virtual_event_webinar_id('virtualEventWebinar-id').presenters.post(request_body)
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Delegated permissions and search for VirtualEvent.ReadWrite
Grant Admin Consent
This delegated permission requires admin consent.