Microsoft Teams Virtual Events (Preview)

  • Reference

Microsoft Teams Virtual Events allows you to access Virtual Event data and be notified of changes.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name J. Markham
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Email jmarkham@microsoft.com
Connector Metadata
Publisher Microsoft
Website https://products.office.com/microsoft-teams/group-chat-software
Privacy policy https://documents.marketo.com/legal/privacy/
Categories Collaboration;Social Media

Connector Overview

The Teams Virtual Events connector uses AADCertification authorization and the connections are not shareable.

Known issues and limitations with actions

Short description Operations Long description
Get Virtual Event GetVirtualEvent Get a virtual event by ID
Get Virtual Events GetVirtualEvents Get all virtual events of the Organizer
Get Virtual Event Session GetVirtualEventSession Get session by ID
Get Virtual Event Sessions GetVirtualEventSessions Get all sessions of the webinar
Get Virtual Event Session Registration GetVirtualEventSessionRegistration Gets a session registration by ID
Get Virtual Event Session Registrations GetVirtualEventSessionRegistrations Gets a session registrations of the event (paginated)
Get Virtual Event Session Attendance Report GetVirtualEventSessionAttendanceReport Gets the attendance report ID of the session
Get Virtual Event Session Attendance Report Records GetVirtualEventSessionAttendanceReportRecords Gets the attendance report records by ID
Poll Event Ended PollEventEnded Polls to see if an event has ended
Poll Attendance Report Ready PollAttendanceReportReady Polls to see if the attendance report is ready

Known issues and limitations with triggers

Short description Operations Long description
Trigger For Virtual Event Changes TriggerForVirtualEventChange Polling trigger to check for changes in registrations or event ending

Creating a connection

The connector supports the following authentication types:
Microsoft Teams Credentials (Teams Public/Teams GCC) Log in with Microsoft Teams Credentials (Teams Public/Teams GCC). All regions Not shareable
Default [DEPRECATED] This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility. All regions Not shareable

Microsoft Teams Credentials (Teams Public/Teams GCC)

Auth ID: oauthPublic

Applicable: All regions

Log in with Microsoft Teams Credentials (Teams Public/Teams GCC).

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 600 seconds
Non-Get requests per connection 300 3600 seconds

Actions

Check to see if the attendance report is ready

Check if attendance report is ready.
Check to see if the session has ended

Check to see if the session has ended.
Get a Virtual Event

Gets a Virtual Event
Get a Virtual Event Session

Gets a Virtual Event Session
Get a Virtual Event Session Attendance Report ID

Gets a Virtual Event Session Attendance ID
Get a Virtual Event Session Registration

Gets a Virtual Event Session Registration
Get all Virtual Event Session registrations

Gets all Virtual Event Session Registrations
Get all Virtual Events

Gets all Virtual Events
Get Virtual Event Session Attendance Report Records by ID

Gets a Virtual Event Session Attendance Records by ID
List Virtual Event Sessions

List the Virtual Event Sessions

Check to see if the attendance report is ready

Operation ID:
PollAttendanceReportReady

Check if attendance report is ready.

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Body
AttendanceReportReadyResponse

Check to see if the session has ended

Operation ID:
PollEventEnded

Check to see if the session has ended.

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Body
EventEnded

Get a Virtual Event

Operation ID:
GetVirtualEvent

Gets a Virtual Event

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Virtual Event

Body
Event

Get a Virtual Event Session

Operation ID:
GetVirtualEventSession

Gets a Virtual Event Session

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Session for a Virtual Event

Body
EventSession

Get a Virtual Event Session Attendance Report ID

Operation ID:
GetVirtualEventSessionAttendanceReport

Gets a Virtual Event Session Attendance ID

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Body
EventSessionAttendanceReportResponse

Get a Virtual Event Session Registration

Operation ID:
GetVirtualEventSessionRegistration

Gets a Virtual Event Session Registration

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID
Virtual Event Attendee Registration
 registrationId True string

Get Virtual Event Attendee Registration by ID

Returns

Attendee registration data

Body
EventSessionRegistration

Get all Virtual Event Session registrations

Operation ID:
GetVirtualEventSessionRegistrations

Gets all Virtual Event Session Registrations

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID
The number of registrations to return
 top integer

The number of registrations to return
The skipToken as return from Graph to ge the next page
 skipToken string

The skipToken as return from Graph to ge the next page

Returns

Attendee registrations

Body
EventSessionRegistrations

Get all Virtual Events

Operation ID:
GetVirtualEvents

Gets all Virtual Events

Returns

Body
Events

Get Virtual Event Session Attendance Report Records by ID

Operation ID:
GetVirtualEventSessionAttendanceReportRecords

Gets a Virtual Event Session Attendance Records by ID

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID
Virtual Event Attendance Report Id
 reportId True string

Virtual Event Attendance Report ID

Returns

Body
EventSessionAttendanceRecords

List Virtual Event Sessions

Operation ID:
GetVirtualEventSessions

List the Virtual Event Sessions

Parameters

Name Key Required Type Description
Virtual Event
 eventId True string

Get Virtual Event by ID

Returns

Body
EventSessions

Triggers

When a change occurs to a Teams Virtual Event webinar, session or attendee (Preview)

Triggers a flow when a Virtual Event change occurs.

When a change occurs to a Teams Virtual Event webinar, session or attendee (Preview)

Operation ID:
TriggerForVirtualEventChange

Triggers a flow when a Virtual Event change occurs.

Parameters

Name Key Required Type Description
The eventId
 eventId True string

The Virtual Event eventId

Returns

Body
OnVirtualEventTriggerResponse

Definitions

BooleanString

NullableBooleanString

EventEnded

Name Path Type Description
minutesEnded
 minutesEnded integer

minutes since event ended. 0 if not ended.
eventEnded
 eventEnded boolean

Flag for event ended.

AttendanceReportReadyResponse

Name Path Type Description
attendanceReportReady
 attendanceReportReady boolean
attendanceReportId
 attendanceReportId string

EventDateTime

Name Path Type Description
dateTime
 dateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
timeZone
 timeZone string

The timezone (in Windows) format)

EventUser

Name Path Type Description
Id
 id string

ID of the user
Id
 displayName string

Display name of the user.
Id
 tenantId string

TenantID where the user is.

EventStatus

The status of the event

The status of the event

string

EventAudience

Audience for the Event

Audience for the Event

string

EventIdentity

Event Identity (user, presenter, attendee)

Name Path Type Description
application
 application string

The application that created identity. May be null
device
 device string

The device the identifywas created on. May be NULL
user
 user EventUser

EventAutoAdmittedUsersRole

EventAttendeeRole

EventSessionAttendanceInterval

Name Path Type Description
joinDateTime
 joinDateTime string
leaveDateTime
 leaveDateTime string
durationInSeconds
 durationInSeconds number

EventSessionAttendanceReportResponse

Name Path Type Description
@odata.context
 @odata.context string
id
 id string
totalParticipantCount
 totalParticipantCount number
meetingStartDateTime
 meetingStartDateTime string
meetingEndDateTime
 meetingEndDateTime string

EventSessionAttendanceRecord

Name Path Type Description
id
 id string
emailAddress
 emailAddress string
totalAttendanceInSeconds
 totalAttendanceInSeconds number
role
 role EventAttendeeRole
registrantId
 registrantId string
identity
 identity EventIdentity

Event Identity (user, presenter, attendee)
attendanceIntervals
 attendanceIntervals array of EventSessionAttendanceInterval

EventSessionAttendanceRecords

Name Path Type Description
@odata.context
 @odata.context string
value
 value array of EventSessionAttendanceRecord

EventCoOrganizers

The co-organizers for an event.

Name Path Type Description
Items
 EventUser

EventSessionCapability

Name Path Type Description
allowAnonymousUsersToDialOut
 allowAnonymousUsersToDialOut NullableBooleanString
autoAdmittedUsers
 autoAdmittedUsers EventAutoAdmittedUsersRole
allowAnonymousUsersToStartMeeting
 allowAnonymousUsersToStartMeeting NullableBooleanString

EventBroadcastMeetingAudience

EventBroadcastMeetingCaptionSettings

Name Path Type Description
isCaptionEnabled
 isCaptionEnabled NullableBooleanString
spokenLanguage
 spokenLanguage string
translationLanguages
 translationLanguages array of string

EventSessionBroadcastMeetingSettings

Name Path Type Description
allowedAudience
 allowedAudience EventBroadcastMeetingAudience
isRecordingEnabled
 isRecordingEnabled NullableBooleanString
isVideoOnDemandEnabled
 isVideoOnDemandEnabled NullableBooleanString
isQuestionAndAnswerEnabled
 isQuestionAndAnswerEnabled NullableBooleanString
isAttendeeReportEnabled
 isAttendeeReportEnabled NullableBooleanString
captions
 captions EventBroadcastMeetingCaptionSettings

EventSessionAttendee

Attendee for an Event Session

Name Path Type Description
upn
 upn string

UPN for the attendee
role
 role EventAttendeeRole
identity
 identity EventIdentity

Event Identity (user, presenter, attendee)

EventSessionMeetingLobbyBypassScope

EventSessionMeetingLobbyBypassOptions

Name Path Type Description
scope
 scope EventSessionMeetingLobbyBypassScope
isDialInBypassEnabled
 isDialInBypassEnabled NullableBooleanString

EventSessionMeetingAudioConferencing

Name Path Type Description
conferenceId
 conferenceId string
tollNumber
 tollNumber string
tollNumbers
 tollNumbers array of string
tollFreeNumber
 tollFreeNumber string
tollFreeNumbers
 tollFreeNumbers array of string
dialinUrl
 dialinUrl string

EventSessionMeetingWatermarkProtectionValues

Name Path Type Description
isEnabledForContentSharing
 isEnabledForContentSharing BooleanString
isEnabledForVideo
 isEnabledForVideo BooleanString

EventSessionMeetingJoinSettings

Name Path Type Description
isPasscodeRequired
 isPasscodeRequired BooleanString
joinMeetingId
 joinMeetingId string
passcode
 passcode string

EventSessionMeetingChatInfo

Name Path Type Description
threadId
 threadId string
messageId
 messageId string
replyChainMessageId
 replyChainMessageId string

EventRegistrationAnswer

Name Path Type Description
questionId
 questionId string
displayName
 displayName string
value
 value string
booleanValue
 booleanValue boolean
multiChoiceValues
 multiChoiceValues array of string

EventContentAndType

The text and format type (text or html)

Name Path Type Description
content
 content string

The content text
contentType
 contentType string

The content type (text or html)

EventSession

Session for a Virtual Event

Name Path Type Description
id
 id string

Id of the session
subject
 subject string

Subject/Description of the session
startDateTime
 startDateTime EventDateTime
endDateTime
 endDateTime EventDateTime
joinUrl
 joinUrl string
joinWebUrl
 joinWebUrl string
isBroadcast
 isBroadcast NullableBooleanString
isEntryExitAnnounced
 isEntryExitAnnounced NullableBooleanString
allowedPresenters
 allowedPresenters NullableBooleanString
allowMeetingChat
 allowMeetingChat NullableBooleanString
allowTeamworkReactions
 allowTeamworkReactions NullableBooleanString
allowAttendeeToEnableMic
 allowAttendeeToEnableMic NullableBooleanString
allowAttendeeToEnableCamera
 allowAttendeeToEnableCamera NullableBooleanString
recordAutomatically
 recordAutomatically NullableBooleanString
anonymizeIdentityForRoles
 anonymizeIdentityForRoles array of EventAttendeeRole
capabilities
 capabilities EventSessionCapability
videoTeleconferenceId
 videoTeleconferenceId string
externalId
 externalId string
allowParticipantsToChangeName
 allowParticipantsToChangeName NullableBooleanString
broadcastSettings
 broadcastSettings EventSessionBroadcastMeetingSettings
lobbyBypassSettings
 lobbyBypassSettings EventSessionMeetingLobbyBypassOptions
audioConferencing
 audioConferencing EventSessionMeetingAudioConferencing
joinInformation
 joinInformation object
watermarkProtection
 watermarkProtection EventSessionMeetingWatermarkProtectionValues
organizer
 participants.organizer EventIdentity

Event Identity (user, presenter, attendee)
attendees
 participants.attendees array of EventSessionAttendee
producers
 producers array of EventIdentity
contributors
 contributors array of EventIdentity
joinMeetingIdSettings
 joinMeetingIdSettings EventSessionMeetingJoinSettings
chatInfo
 chatInfo EventSessionMeetingChatInfo

EventSessions

Name Path Type Description
@odata-context
 @odata-context string
value
 value array of EventSession

EventSessionRegistrationStatus

EventSessionRegistration

Attendee registration data

Name Path Type Description
id
 id string
userId
 userId string
firstName
 firstName string
lastName
 lastName string
email
 email string
status
 status EventSessionRegistrationStatus
registrationDateTime
 registrationDateTime string
cancelationDateTime
 cancelationDateTime string
registrationQuestionAnswers
 registrationQuestionAnswers array of EventRegistrationAnswer

EventSessionRegistrations

Attendee registrations

Name Path Type Description
value
 value array of EventSessionRegistration
@odata.nextLink
 @odata.nextLink string

@odata.nextLink

Event

Virtual Event

Name Path Type Description
id
 id string

Id of the Virtual Event
status
 status EventStatus

The status of the event
displayName
 displayName string

The name of the event.
description
 description EventContentAndType

The text and format type (text or html)
audience
 audience EventAudience

Audience for the Event
startDateTime
 startDateTime EventDateTime
endDateTime
 endDateTime EventDateTime
createdBy
 createdBy EventIdentity

Event Identity (user, presenter, attendee)
organizers
 organizers EventCoOrganizers

The co-organizers for an event.

Events

Name Path Type Description
@odata-context
 @odata-context string
value
 value array of Event

OnVirtualEventTriggerResponse

Name Path Type Description
Polling Notification Action
 action string

Polling Notification Action.