Skip to content

Latest commit

 

History

History
252 lines (191 loc) · 8.93 KB

virtualevent-post-presenters.md

File metadata and controls

252 lines (191 loc) · 8.93 KB
Raw
title description author ms.localizationpriority ms.subservice doc_type
Create virtualEventPresenter
Create a new virtualEventPresenter object to a virtual event.
frankpeng7
medium
cloud-communications
apiPageType

Create virtualEventPresenter

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Create a new virtualEventPresenter object on a virtual event.

Currently the supported virtual event types are: virtualEventTownhall, virtualEventWebinar.

[!INCLUDE national-cloud-support]

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

[!INCLUDE permissions-table]

HTTP request

POST /solutions/virtualEvents/townhalls/{townhallId}/presenters
POST /solutions/virtualEvents/webinars/{webinarId}/presenters

Request headers

Name Description
Authorization Bearer {token}. Required.
Content-Type application/json. Required.

Request body

In the request body, supply a JSON representation of the virtualEventPresenter object.

You can specify the following properties when you create a presenter on a virtualEventTownhall:

Property Type Description
identity identity Identity information of the presenter. The supported identities are: communicationsGuestIdentity and communicationsUserIdentity.

You can specify the following properties when you create a presenter on a virtualEventWebinar:

Property Type Description
identity identity Identity information of the presenter. The supported identities are: communicationsGuestIdentity and communicationsUserIdentity.
presenterDetails virtualEventPresenterDetails Other detail information of the presenter.

Response

If successful, this method returns a 201 Created response code and a virtualEventPresenter object in the response body.

Examples

Example 1: Create an in-tenant presenter

The following example shows how to create an internal user as a presenter on a virtualEventTownhall.

Request

The following example shows a request.

HTTP

POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters
Content-Type: application/json

{
  "identity": {
    "@odata.type": "#microsoft.graph.communicationsUserIdentity",
    "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b"
  }
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

CLI

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
  "email": "kenneth.brown@contoso.com",
  "identity": {
    "@odata.type": "#microsoft.graph.communicationsUserIdentity",
    "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
    "displayName": "Kennth Brown",
    "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
  },
  "presenterDetails": null
}

Example 2: Create an out-of-tenant presenter

The following example shows how to create a guest user as a presenter on a virtualEventTownhall.

Request

The following example shows a request.

HTTP

POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/502dadea-b5d8-44aa-a851-a0ac496a36bf@09a21d49-f0f3-4b3f-96b6-f381e9430742/presenters
Content-Type: application/json

{
  "identity": {
    "@odata.type": "#microsoft.graph.communicationsGuestIdentity",
    "displayName": "Guest Speaker",
    "email": "guest.speaker@fabrikam.com"
  }
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

CLI

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "184975c0-4096-4a02-b251-c48546691c42",
  "email": "guest.speaker@fabrikam.com",
  "presenterDetails": null,
  "identity": {
    "@odata.type": "#microsoft.graph.communicationsGuestIdentity",
    "id": "184975c0-4096-4a02-b251-c48546691c42",
    "displayName": "Guest Speaker",
    "email": "guest.speaker@fabrikam.com"
  }
}