Working with the communications API in Microsoft Graph
APIs under the
/beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
The Microsoft Graph communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. You can use this API to create and receive calls, create and retrieve meeting coordinates, and check users' presence.
You can use the communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users and to check their presence availability and activity. This API provides calling functionality as well as the ability to create and retrieve online meetings. You can use service applications (bots) with this API, where the bot can act as a participant in your VoIP calls or Microsoft Teams meetings, for example.
One of the following permissions is required to access the communications API. These permissions need to be granted by the administrator
|Calling||Calls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.Initiate.All, Calls.InitiateGroupCalls.All, Calls.AccessMedia.All|
Common use cases
The following table lists some of the common uses for the communications API.
|Use cases||REST resources||See also|
|Creating and joining 1-1 and group calls||Call||Methods for calls|
|IVR calls||Methods for IVR|
|Call controls (participant)||Participant|
|Meetings||onlineMeeting||Methods for meetings|
|Presence||presence||Methods for presence|
|Retrieving call records||callRecord||Webhook subscriptions|
Find out about the latest new features and updates for this API set.