VirtualEvent.ReadWrite

Allows the app to read and write virtual events for you

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the VirtualEvent.ReadWrite permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	d38d189c-e29b-4344-8b3b-829bfa81380b
DisplayText	-	Read and write your virtual events
Description	-	Allows the app to read and write virtual events for you
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId}
	DELETE /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	DELETE /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions/{questionId}
	GET /solutions/virtualEvents/townhalls/{id}
	GET /solutions/virtualEvents/townhalls/{townhallId}/presenters
	GET /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId}
	GET /solutions/virtualEvents/townhalls/getByUserIdAndRole(userId='{userId}', role='{role}')
	GET /solutions/virtualEvents/townhalls/getByUserRole(role='{role}')
	GET /solutions/virtualEvents/webinars/{webinarId}
	GET /solutions/virtualEvents/webinars/{webinarId}/presenters
	GET /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	GET /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration
	GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}
	GET /solutions/virtualEvents/webinars/{webinarId}/sessions
	GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}
	GET /solutions/virtualEvents/webinars/getByUserIdAndRole(userId='{userId}', role='{role}')
	GET /solutions/virtualEvents/webinars/getByUserRole(role='{role}')
	PATCH /solutions/virtualEvents/townhalls/{id}
	PATCH /solutions/virtualEvents/webinars/{id}
	PATCH /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	POST /solutions/virtualEvents/townhalls
	POST /solutions/virtualEvents/townhalls/{id}/cancel
	POST /solutions/virtualEvents/townhalls/{id}/publish
	POST /solutions/virtualEvents/townhalls/{id}/setExternalEventInformation
	POST /solutions/virtualEvents/townhalls/{townhallId}/presenters
	POST /solutions/virtualEvents/webinars
	POST /solutions/virtualEvents/webinars/{id}/cancel
	POST /solutions/virtualEvents/webinars/{id}/publish
	POST /solutions/virtualEvents/webinars/{webinarId}/presenters
	POST /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions
	POST /solutions/virtualEvents/webinars/{webinarId}/registrations
	POST /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/cancel

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId}
	DELETE /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	DELETE /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions/{questionId}
	GET /solutions/virtualEvents/townhalls/{id}
	GET /solutions/virtualEvents/townhalls/{townhallId}/presenters
	GET /solutions/virtualEvents/townhalls/{townhallId}/presenters/{presenterId}
	GET /solutions/virtualEvents/townhalls/getByUserIdAndRole(userId='{userId}', role='{role}')
	GET /solutions/virtualEvents/townhalls/getByUserRole(role='{role}')
	GET /solutions/virtualEvents/webinars/{id}
	GET /solutions/virtualEvents/webinars/{webinarId}/presenters
	GET /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	GET /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration
	GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}
	GET /solutions/virtualEvents/webinars/{webinarId}/sessions
	GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}
	GET /solutions/virtualEvents/webinars/getByUserIdAndRole(userId='{userId}', role='{role}')
	GET /solutions/virtualEvents/webinars/getByUserRole(role='{role}')
	PATCH /solutions/virtualEvents/townhalls/{id}
	PATCH /solutions/virtualEvents/webinars/{id}
	PATCH /solutions/virtualEvents/webinars/{webinarId}/presenters/{presenterId}
	POST /solutions/virtualEvents/townhalls
	POST /solutions/virtualEvents/townhalls/{id}/cancel
	POST /solutions/virtualEvents/townhalls/{id}/publish
	POST /solutions/virtualEvents/townhalls/{id}/setExternalEventInformation
	POST /solutions/virtualEvents/townhalls/{townhallId}/presenters
	POST /solutions/virtualEvents/webinars
	POST /solutions/virtualEvents/webinars/{id}/cancel
	POST /solutions/virtualEvents/webinars/{id}/publish
	POST /solutions/virtualEvents/webinars/{webinarId}/presenters
	POST /solutions/virtualEvents/webinars/{webinarId}/registrationConfiguration/questions
	POST /solutions/virtualEvents/webinars/{webinarId}/registrations
	POST /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}/cancel

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaVirtualEventTownhall
	Get-MgBetaVirtualEventTownhallByUserRole
	Get-MgVirtualEventTownhall
	Get-MgVirtualEventTownhallPresenter
	Get-MgVirtualEventWebinar
	Get-MgVirtualEventWebinarByUserRole
	Get-MgVirtualEventWebinarRegistration
	Get-MgVirtualEventWebinarRegistrationConfiguration
	Get-MgVirtualEventWebinarSession
	New-MgVirtualEventTownhall
	New-MgVirtualEventTownhallPresenter
	New-MgVirtualEventWebinar
	New-MgVirtualEventWebinarRegistration
	New-MgVirtualEventWebinarRegistrationConfigurationQuestion
	Remove-MgVirtualEventTownhallPresenter
	Remove-MgVirtualEventWebinarRegistrationConfigurationQuestion
	Stop-MgVirtualEventWebinarRegistration
	Update-MgVirtualEventTownhall
	Update-MgVirtualEventWebinar
	Update-MgVirtualEventWebinarPresenter

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaVirtualEventTownhall
	Get-MgBetaVirtualEventTownhallByUserRole
	Get-MgBetaVirtualEventTownhallPresenter
	Get-MgBetaVirtualEventWebinar
	Get-MgBetaVirtualEventWebinarByUserRole
	Get-MgBetaVirtualEventWebinarRegistration
	Get-MgBetaVirtualEventWebinarRegistrationConfiguration
	Get-MgBetaVirtualEventWebinarSession
	New-MgBetaVirtualEventTownhall
	New-MgBetaVirtualEventTownhallPresenter
	New-MgBetaVirtualEventWebinar
	New-MgBetaVirtualEventWebinarRegistration
	New-MgBetaVirtualEventWebinarRegistrationConfigurationQuestion
	Remove-MgBetaVirtualEventTownhallPresenter
	Remove-MgBetaVirtualEventWebinarRegistrationConfigurationQuestion
	Stop-MgBetaVirtualEventWebinarRegistration
	Update-MgBetaVirtualEventTownhall
	Update-MgBetaVirtualEventWebinar
	Update-MgBetaVirtualEventWebinarPresenter

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: communicationsGuestIdentity

Property	Type	Description
displayName	String	The display name associated with the guest user. Inherited from identity.
email	String	The email of the guest user.
id	String	The unique identifier for the guest user. Inherited from **i

Graph reference: communicationsUserIdentity

Property	Type	Description
displayName	String	The display name associated with the user. Inherited from identity.
id	String	The user's object ID. Inherited from identity.
tenantId	String	The user's tenant ID.

Graph reference: dateTimeTimeZone

Property	Type	Description
dateTime	String	A single point of time in a combined date and time representation (`{date}T{time}`; for example, `2017-08-29T04:00:00.0000000`).
timeZone	String	Represents a time zone, for example, "Pacific Standard Time". See below for more possible values.

Graph reference: identity

Property	Type	Description
displayName	String	The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
id	String	Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
tenantId	String	Unique identity of the tenant. Optional.
thumbnails	thumbnailSet	Keyed collection of thumbnail resources. Optional. Applies to drive items, for example.

Property	Type	Description
content	String	The content of the item.
contentType	bodyType	The type of the content. Possible values are `text` and `html`.

Graph reference: virtualEvent

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	String	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`.

Graph reference: virtualEventExternalInformation

Property	Type	Description
applicationId	String	Identifier of the application that hosts the externalEventId. Read-only.
externalEventId	String	The identifier for a **v

Graph reference: virtualEventExternalRegistrationInformation

Property	Type	Description
referrer	String	A URL or string that represents the location from which the registrant registered. Optional.
registrationId	String	The identifier for a **v

Graph reference: virtualEventPresenter

Property	Type	Description
email	String	Email address of the presenter.
id	String	Unique identifier of the presenter. Inherited from entity.
identity	identity	Identity information of the presenter. The supported identities are: communicationsGuestIdentity and communicationsUserIdentity.
presenterDetails	virtualEventPresenterDetails	Other details about the presenter. This property returns `null` when the virtual event type is virtualEventTownhall.

Graph reference: virtualEventPresenterDetails

Property	Type	Description
bio	itemBody	Bio of the presenter.
company	String	The presenter's company name.
jobTitle	String	The presenter's job title.
linkedInProfileWebUrl	String	The presenter's LinkedIn profile URL.
personalSiteWebUrl	String	The presenter's personal website URL.
photo	Stream	The content stream of the presenter's photo.
twitterProfileWebUrl	String	The presenter's Twitter profile URL.

Graph reference: virtualEventRegistration

Property	Type	Description
cancelationDateTime	DateTimeOffset	Date and time when the registrant cancels their registration for the virtual event. Only appears when applicable. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
email	String	Email address of the registrant.
externalRegistrationInformation	virtualEventExternalRegistrationInformation	The external information for a virtual event registration.
firstName	String	First name of the registrant.
id	String	Unique identifier of the registrant. Read-only. Inherited from entity.
lastName	String	Last name of the registrant.
preferredTimezone	String	The registrant's time zone details.
preferredLanguage	String	The registrant's preferred language.
registrationDateTime	DateTimeOffset	Date and time when the registrant registers for the virtual event. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
registrationQuestionAnswers	virtualEventRegistrationQuestionAnswer collection	The registrant's answer to the registration questions.
status	virtualEventAttendeeRegistrationStatus	Registration status of the registrant. Read-only. Possible values are `registered`, `canceled`, `waitlisted`, `pendingApproval`, `rejectedByOrganizer`, and `unknownFutureValue`.
userId	String	The registrant's ID in Microsoft Entra ID. Only appears when the registrant is registered in Microsoft Entra ID.

Graph reference: virtualEventRegistrationCustomQuestion

Property	Type	Description
answerChoices	String collection	Answer choices when answerInputType is `singleChoice` or `multiChoice`.
answerInputType	virtualEventRegistrationQuestionAnswerInputType	Input type of the registration question answer. Possible values are `text`, `multilineText`, `singleChoice`, `multiChoice`, `boolean`, and `unknownFutureValue`.
displayName	String	Display name of the registration question. Inherited from virtualEventRegistrationQuestionBase.
id	String	Unique identifier of the registration question. Inherited from virtualEventRegistrationQuestionBase.
isRequired	Boolean	Indicates whether an answer to the question is required. The default value is `false`. Inherited from virtualEventRegistrationQuestionBase.

Graph reference: virtualEventRegistrationPredefinedQuestion

Property	Type	Description
label	virtualEventRegistrationPredefinedQuestionLabel	Label of the predefined registration question. It accepts a single line of text: `street`, `city`, `state`, `postalCode`, `countryOrRegion`, `industry`, `jobTitle`, `organization`, and `unknownFutureValue`.

Graph reference: virtualEventRegistrationQuestionAnswer

Property	Type	Description
booleanValue	Boolean	Boolean answer of the virtual event registration question. Only appears when answerInputType is `boolean`.
displayName	String	Display name of the registration question.
multiChoiceValues	String collection	Collection of text answer of the virtual event registration question. Only appears when answerInputType is `multiChoice`.
questionId	String	id of the virtual event registration question.
value	String	Text answer of the virtual event registration question. Appears when **a

Graph reference: virtualEventRegistrationQuestionBase

Property	Type	Description
displayName	String	Display name of the registration question.
id	String	Unique identifier of the registration question. Inherited from entity.
isRequired	Boolean	Indicates whether an answer to the question is required. The default value is `false`.

Graph reference: virtualEventSession

Property	Type	Description
allowAttendeeToEnableCamera	Boolean	Indicates whether attendees can turn on their camera. Inherited from onlineMeetingBase.
allowAttendeeToEnableMic	Boolean	Indicates whether attendees can turn on their microphone. Inherited from onlineMeetingBase.
allowBreakoutRooms	Boolean	Indicates whether breakout rooms are enabled for the virtual event session. Inherited from onlineMeetingBase.
allowCopyingAndSharingMeetingContent	Boolean	Indicates whether the ability to copy and share meeting content is enabled for the virtual event session. 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 virtual event session. Inherited from onlineMeetingBase.
allowLiveShare	meetingLiveShareOptions	Indicates whether live share is enabled for the virtual event session. The possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowMeetingChat	meetingChatMode	Specifies the mode of meeting chat. Inherited from onlineMeetingBase.
allowParticipantsToChangeName	Boolean	Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from onlineMeetingBase.
allowPowerPointSharing	Boolean	Indicates whether PowerPoint live is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowRecording	Boolean	Indicates whether recording is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowTeamworkReactions	Boolean	Indicates whether Teams reactions are enabled for the virtual event session. Inherited from onlineMeetingBase.
allowTranscription	Boolean	Indicates whether transcription is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowWhiteboard	Boolean	Indicates whether whiteboard is enabled for the virtual event session. Inherited from onlineMeetingBase.
anonymizeIdentityForRoles	onlineMeetingRole collection	Specifies whose identity is anonymized in the virtual event session. The possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from onlineMeetingBase.
audioConferencing	audioConferencing	The phone access (dial-in) information for the virtual event session. Read-only. Inherited from onlineMeetingBase.
chatRestrictions	chatRestrictions	Specifies the configuration settings for meeting chat restrictions. Inherited from onlineMeetingBase.
chatInfo	chatInfo	The chat information associated with the virtual event session. Inherited from onlineMeetingBase.
endDateTime	DateTimeTimeZone	The virtual event session end time.
expiryDateTime	DateTimeOffset	Indicates the date and time when the meeting resource expires. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from onlineMeetingBase.
id	String	The unique identifier of the virtual event session. Read-only. Inherited from onlineMeetingBase.
isEndToEndEncryptionEnabled	Boolean	Indicates whether end-to-end encryption (E2EE) is enabled for the virtual event session. Inherited from onlineMeetingBase.
isEntryExitAnnounced	Boolean	Indicates whether to announce when callers join or leave. Inherited from onlineMeetingBase.
joinInformation	itemBody	The join information of the virtual event session. Read-only. Inherited from onlineMeetingBase.
joinMeetingIdSettings	joinMeetingIdSettings	Specifies the joinMeetingId, the meeting passcode, and the requirement for the passcode. Inherited from onlineMeetingBase.
joinWebUrl	String	The join URL of the virtual event session. Read-only. Inherited from onlineMeetingBase.
lobbyBypassSettings	lobbyBypassSettings	Specifies which participants can bypass the meeting lobby. Inherited from onlineMeetingBase.
meetingOptionsWebUrl	String	Provides the URL to the Teams meeting options page for the specified meeting. This link allows only the organizer to configure meeting settings. Inherited from onlineMeetingBase.
meetingSpokenLanguageTag	String	Specifies the spoken language used during the meeting for recording and transcription purposes. Inherited from onlineMeetingBase.
recordAutomatically	Boolean	Indicates whether to record the virtual event session automatically. Inherited from onlineMeetingBase.
sensitivityLabelAssignment	onlineMeetingSensitivityLabelAssignment	Specifies the sensitivity label applied to the Teams meeting. Inherited from onlineMeetingBase.
startDateTime	DateTimeTimeZone	The virtual event session start time.
subject	String	The subject of the virtual event session. Inherited from onlineMeetingBase.
videoOnDemandWebUrl	String	The URL of the video on demand (VOD) for Microsoft Teams events that allows webinar and town hall organizers to quickly publish and share event recordings.
videoTeleconferenceId	String	The video teleconferencing ID. Read-only. Inherited from onlineMeetingBase.
watermarkProtection	watermarkProtectionValues	Specifies whether the client application should apply a watermark to a content type. Inherited from onlineMeetingBase.

Property	Type	Description
isAttendeeEmailNotificationEnabled	Boolean	Indicates whether virtual event attendees receive email notifications.

Graph reference: virtualEventTownhall

Property	Type	Description
audience	meetingAudience	The audience to whom the town hall is visible. The possible values are: `everyone`, `organization`, and `unknownFutureValue`.
coOrganizers	communicationsUserIdentity collection	Identity information of the coorganizers of the town hall.
createdBy	communicationsIdentitySet	Identity information of the creator of the town hall. Inherited from virtualEvent. Read-only.
description	itemBody	Description of the town hall. Inherited from virtualEvent.
displayName	String	Display name of the town hall. Inherited from virtualEvent.
endDateTime	dateTimeTimeZone	Date and time when the town hall ends. 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. Inherited from virtualEvent.
externalEventInformation	virtualEventExternalInformation collection	The external information of a town hall. Returned only for event organizers or coorganizers; otherwise, `null`.
id	String	Unique identifier of the town hall. Inherited from entity. Read-only.
invitedAttendees	identity collection	The attendees invited to the town hall. The supported identities are: communicationsUserIdentity and communicationsGuestIdentity.
isInviteOnly	Boolean	Indicates whether the town hall is only open to invited people and groups within your organization. The isInviteOnly property can only be `true` if the value of the audience property is set to `organization`.
settings	virtualEventSettings	The virtual event settings.
startDateTime	dateTimeTimeZone	Date and time when the town hall starts. 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. Inherited from virtualEvent.
status	virtualEventStatus	Status of the town hall. The possible values are: `draft`, `published`, `canceled`, and `unknownFutureValue`. Inherited from virtualEvent.

Graph reference: virtualEventWebinar

Property	Type	Description
audience	meetingAudience	To whom the webinar is visible. The possible values are: `everyone`, `organization`, and `unknownFutureValue`.
coOrganizers	communicationsUserIdentity collection	Identity information of coorganizers of the webinar.
createdBy	communicationsIdentitySet	Identity information for the creator of the webinar. Inherited from virtualEvent.
description	itemBody	Description of the webinar. Inherited from virtualEvent.
displayName	String	Display name of the webinar. Inherited from virtualEvent.
endDateTime	dateTimeTimeZone	End time of the webinar. 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 webinar. Returned only for event organizers or coorganizers; otherwise, `null`.
startDateTime	dateTimeTimeZone	Start time of the webinar. 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.
id	String	Unique identifier of the webinar. Inherited from entity.
settings	virtualEventSettings	The webinar settings. Inherited from virtualEvent.
status	virtualEventStatus	Status of the webinar. The possible values are: `draft`, `published`, `canceled`, and `unknownFutureValue`. Inherited from virtualEvent.

Graph reference: virtualEventWebinarRegistrationConfiguration

Property	Type	Description
registrationWebUrl	String	Registration portal URL of the webinar. Inherited from virtualEventRegistrationConfiguration.

Table of Contents

VirtualEvent.ReadWrite

Graph Methods

Resources