Chat.Create

Allows the app to create chats on behalf of the signed-in user.

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 Chat.Create 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	d9c48af6-9ad9-47ad-82c3-63757137b9af	38826093-1258-4dea-98f0-00003be2b8d0
DisplayText	Create chats	Create chats
Description	Allows the app to create chats without a signed-in user.	Allows the app to create chats on behalf of the signed-in user.
AdminConsentRequired	Yes	No

Graph Methods

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

	Methods
	POST /chats

	Commands
	New-MgChat

	Commands
	New-MgBetaChat

Resources

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

Graph reference: chat

Property	Type	Description
chatType	chatType	Specifies the type of chat. Possible values are: `group`, `oneOnOne`, `meeting`, `unknownFutureValue`.
createdDateTime	dateTimeOffset	Date and time at which the chat was created. Read-only.
id	String	The chat's unique identifier. Read-only.
lastUpdatedDateTime	dateTimeOffset	Date and time at which the chat was renamed or the list of members was last changed. Read-only.
onlineMeetingInfo	teamworkOnlineMeetingInfo	Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
tenantId	String	The identifier of the tenant in which the chat was created. Read-only.
topic	String	(Optional) Subject or topic for the chat. Only available for group chats.
viewpoint	chatViewpoint	Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context.
webUrl	String	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.

Graph reference: conversationMember

Property	Type	Description
displayName	string	The display name of the user.
id	String	Read-only. Unique ID of the user.
roles	string collection	The roles for that user. This property contains additional qualifiers only when relevant - for example, if the member has `owner` privileges, the roles property contains `owner` as one of the values. Similarly, if the member is an in-tenant guest, the roles property contains `guest` as one of the values. A basic member should not have any values specified in the roles property. An Out-of-tenant external member is assigned the `owner` role.
visibleHistoryStartDateTime	DateTimeOffset	The timestamp denoting how far back a conversation's history is shared with the conversation member. This property is settable only for members of a chat.

Graph reference: teamsApp

Property	Type	Description
displayName	string	The name of the catalog app provided by the app developer in the Microsoft Teams zip app package.
distributionMethod	teamsAppDistributionMethod	The method of distribution for the app. Read-only.
externalId	string	The ID of the catalog provided by the app developer in the Microsoft Teams zip app package.
id	string	The app ID generated for the catalog is different from the developer-provided ID found within the Microsoft Teams zip app package. The **e

Graph reference: teamsAsyncOperation

Property	Type	Description
attemptsCount	Int32	Number of times the operation was attempted before being marked successful or failed.
createdDateTime	DateTimeOffset	Time when the operation was created.
error	operationError	Any error that causes the async operation to fail.
id	string	Unique operation ID.
lastActionDateTime	DateTimeOffset	Time when the async operation was last updated.
operationType	teamsAsyncOperationType	Denotes the type of operation described. Possible values are: `invalid`, `cloneTeam`, `archiveTeam`, `unarchiveTeam`, `createTeam`, `unknownFutureValue`, `teamifyGroup`, `createChannel`, `archiveChannel`, `unarchiveChannel`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `teamifyGroup`, `createChannel`, `archiveChannel`, `unarchiveChannel`.
status	teamsAsyncOperationStatus	Operation status.
targetResourceId	String	The ID of the object that's created or modified as result of this async operation, typically a team.
targetResourceLocation	string	The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths.

Table of Contents

Chat.Create

Graph Methods

Resources