Add app to chat

Namespace: microsoft.graph

Install a teamsApp to the specified chat.


  • If the chat is associated with an onlineMeeting instance, then, effectively, the teamsApp will get installed to the meeting.
  • Currently, this operation does not support installation of apps that require resource-specific consent permissions. For details, see Known issues.


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

Permission type Permissions (from least to most privileged)
Delegated (work or school account) TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat
Delegated (personal Microsoft account) Not supported.
Application TeamsAppInstallation.ReadWriteSelfForChat.All, TeamsAppInstallation.ReadWriteForChat.All

HTTP request

POST /chats/{chat-id}/installedApps

Request headers

Header Value
Authorization Bearer {token}. Required.
Content-Type application/json. Required.

Request body

The request body should contain the catalog app's generated app ID. For details, see teamsApp properties.


If successful, this method returns a 201 Created response code.



Content-Type: application/json



HTTP/1.1 201 Created