| title | Use the Microsoft Graph API to get change notifications |
|---|---|
| description | Deliver change notifications to clients. |
| ms.localizationpriority | medium |
| author | jessieli-ad |
| doc_type | conceptualPageType |
| ms.subservice | change-notifications |
| ms.date | 06/07/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
[!INCLUDE todo-deprecate-basetaskapi-sharedfeature]
The Microsoft Graph REST API can deliver change notifications to clients through various endpoints, including webhooks, Event Hubs, and Event Grid. To learn how to subscribe and receive notifications for your application, see Set up notifications for changes in user data.
[!INCLUDE change-notifications-supported-resources-expanded]
Note: Any resource path that begins with
/users/{id}can also accept/meto reference the signed-in user.
In general, subscription operations require read permission to the resource. For example, to get notifications for messages, your app needs the Mail.Read permission. The create subscription article lists permissions needed for each resource type. The following table lists the types of permissions your app can request to use webhooks for specific resource types.
| Permission type | Supported resource types |
|---|---|
| Delegated - work or school account | aiInteraction, alert, callRecording, callTranscript, channel, chat, chatMessage (preview), contact, conversation, conversationMember, driveItem, event, group, list, message, offerShiftRequest, openShiftChangeRequest, presence, shift, swapShiftsChangeRequest, team, timeOffRequest, todoTask, user, baseTask (deprecated) |
| Delegated - personal Microsoft account | contact, driveItem, event, list, message, todoTask, baseTask (deprecated) |
| Application | aiInteraction, alert, callRecord, approvals, callRecording, callTranscript, channel, chat, chatMessage, contact, conversationMember, driveItem, event, group, list, message, offerShiftRequest, onlineMeeting, openShiftChangeRequest, printer, printTaskDefinition, shift, swapShiftsChangeRequest, team, timeOffRequest, user |