Skip to content

Commit 3c7253b

Browse files
committed
Available event types for Outlook Message resource
1 parent 9c154c8 commit 3c7253b

File tree

3 files changed

+122
-26
lines changed

3 files changed

+122
-26
lines changed

articles/event-grid/outlook-events.md

Lines changed: 106 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Outlook events in Azure Event Grid
33
description: This article describes Microsoft Outlook events in Azure Event Grid.
44
ms.topic: conceptual
5-
ms.date: 06/09/2022
5+
ms.date: 05/22/2024
66
---
77

88
# Microsoft Outlook events
@@ -20,6 +20,10 @@ These events are triggered when an Outlook event or an Outlook contact is create
2020
| **Microsoft.Graph.ContactCreated** | Triggered when a contact in Outlook is created. |
2121
| **Microsoft.Graph.ContactUpdated** | Triggered when a contact in Outlook is updated. |
2222
| **Microsoft.Graph.ContactDeleted** | Triggered when a contact in Outlook is deleted. |
23+
| **Microsoft.Graph.MessageCreated** | Triggered when a message in Outlook is created. |
24+
| **Microsoft.Graph.MessageUpdated** | Triggered when a message in Outlook is updated. |
25+
| **Microsoft.Graph.MessageDeleted** | Triggered when a message in Outlook is deleted. |
26+
2327

2428
## Example event
2529
When an event is triggered, the Event Grid service sends data about that event to subscribing destinations. This section contains an example of what that data would look like for each Outlook event.
@@ -32,13 +36,13 @@ When an event is triggered, the Event Grid service sends data about that event t
3236
"type": "Microsoft.Graph.EventCreated",
3337
"source": "/tenants/<tenant-id>/applications/<application-id>",
3438
"subject": "Events/<event-id>",
35-
"time": "2022-05-24T22:24:31.3062901Z",
39+
"time": "2024-05-22T22:24:31.3062901Z",
3640
"datacontenttype": "application/json",
3741
"specversion": "1.0",
3842
"data": {
3943
"@odata.type": "#Microsoft.OutlookServices.Notification",
4044
"Id": null,
41-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
45+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
4246
"ChangeType": "created",
4347
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
4448
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
@@ -62,13 +66,13 @@ When an event is triggered, the Event Grid service sends data about that event t
6266
"type": "Microsoft.Graph.EventUpdated",
6367
"source": "/tenants/<tenant-id>/applications/<application-id>",
6468
"subject": "Events/<event-id>",
65-
"time": "2022-05-24T22:24:31.3062901Z",
69+
"time": "2024-05-22T22:24:31.3062901Z",
6670
"datacontenttype": "application/json",
6771
"specversion": "1.0",
6872
"data": {
6973
"@odata.type": "#Microsoft.OutlookServices.Notification",
7074
"Id": null,
71-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
75+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
7276
"ChangeType": "updated",
7377
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
7478
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
@@ -91,13 +95,13 @@ When an event is triggered, the Event Grid service sends data about that event t
9195
"type": "Microsoft.Graph.EventDeleted",
9296
"source": "/tenants/<tenant-id>/applications/<application-id>",
9397
"subject": "Events/<event-id>",
94-
"time": "2022-05-24T22:24:31.3062901Z",
98+
"time": "2024-05-22T22:24:31.3062901Z",
9599
"datacontenttype": "application/json",
96100
"specversion": "1.0",
97101
"data": {
98102
"@odata.type": "#Microsoft.OutlookServices.Notification",
99103
"Id": null,
100-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
104+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
101105
"ChangeType": "deleted",
102106
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
103107
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
@@ -121,13 +125,13 @@ When an event is triggered, the Event Grid service sends data about that event t
121125
"type": "Microsoft.Graph.ContactCreated",
122126
"source": "/tenants/<tenant-id>/applications/<application-id>",
123127
"subject": "Contacts/<contact-id>",
124-
"time": "2022-05-24T22:24:31.3062901Z",
128+
"time": "2024-05-22T22:24:31.3062901Z",
125129
"datacontenttype": "application/json",
126130
"specversion": "1.0",
127131
"data": {
128132
"@odata.type": "#Microsoft.OutlookServices.Notification",
129133
"Id": null,
130-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
134+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
131135
"ChangeType": "created",
132136
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
133137
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
@@ -151,13 +155,13 @@ When an event is triggered, the Event Grid service sends data about that event t
151155
"type": "Microsoft.Graph.ContactUpdated",
152156
"source": "/tenants/<tenant-id>/applications/<application-id>",
153157
"subject": "Contacts/<contact-id>",
154-
"time": "2022-05-24T22:24:31.3062901Z",
158+
"time": "2024-05-22T22:24:31.3062901Z",
155159
"datacontenttype": "application/json",
156160
"specversion": "1.0",
157161
"data": {
158162
"@odata.type": "#Microsoft.OutlookServices.Notification",
159163
"Id": null,
160-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
164+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
161165
"ChangeType": "updated",
162166
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
163167
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
@@ -180,13 +184,13 @@ When an event is triggered, the Event Grid service sends data about that event t
180184
"type": "Microsoft.Graph.ContactDeleted",
181185
"source": "/tenants/<tenant-id>/applications/<application-id>",
182186
"subject": "Contacts/<contact-id>",
183-
"time": "2022-05-24T22:24:31.3062901Z",
187+
"time": "2024-05-22T22:24:31.3062901Z",
184188
"datacontenttype": "application/json",
185189
"specversion": "1.0",
186190
"data": {
187191
"@odata.type": "#Microsoft.OutlookServices.Notification",
188192
"Id": null,
189-
"SubscriptionExpirationDateTime": "2019-02-14T23:56:30.1307708Z",
193+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
190194
"ChangeType": "deleted",
191195
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
192196
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
@@ -202,6 +206,95 @@ When an event is triggered, the Event Grid service sends data about that event t
202206
}
203207
```
204208

209+
### Microsoft.Graph.MessageCreated event
210+
211+
```json
212+
{
213+
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
214+
"type": "Microsoft.Graph.MessageCreated",
215+
"source": "/tenants/<tenant-id>/applications/<application-id>",
216+
"subject": "Messages/<messaeg-id>",
217+
"time": "2024-05-22T22:24:31.3062901Z",
218+
"datacontenttype": "application/json",
219+
"specversion": "1.0",
220+
"data": {
221+
"@odata.type": "#Microsoft.OutlookServices.Notification",
222+
"Id": null,
223+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
224+
"ChangeType": "created",
225+
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
226+
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
227+
"clientState": "<client state>",
228+
"resourceData": {
229+
"Id": "<message id>",
230+
"@odata.etag": "<tag id>",
231+
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
232+
"@odata.type": "#Microsoft.OutlookServices.Message",
233+
"OtherResourceData": "<some other resource data>"
234+
}
235+
}
236+
}
237+
```
238+
239+
### Microsoft.Graph.MessageUpdated event
240+
241+
```json
242+
{
243+
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
244+
"type": "Microsoft.Graph.MessageUpdated",
245+
"source": "/tenants/<tenant-id>/applications/<application-id>",
246+
"subject": "Messages/<message-id>",
247+
"time": "2024-05-22T22:24:31.3062901Z",
248+
"datacontenttype": "application/json",
249+
"specversion": "1.0",
250+
"data": {
251+
"@odata.type": "#Microsoft.OutlookServices.Notification",
252+
"Id": null,
253+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
254+
"ChangeType": "updated",
255+
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
256+
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
257+
"clientState": "<client state>",
258+
"resourceData": {
259+
"Id": "<message id>",
260+
"@odata.etag": "<tag id>",
261+
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
262+
"@odata.type": "#Microsoft.OutlookServices.Message",
263+
"OtherResourceData": "<some other resource data>"
264+
}
265+
}
266+
}
267+
```
268+
### Microsoft.Graph.MessageDeleted event
269+
270+
```json
271+
{
272+
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
273+
"type": "Microsoft.Graph.MessageDeleted",
274+
"source": "/tenants/<tenant-id>/applications/<application-id>",
275+
"subject": "Message/<messaeg-id>",
276+
"time": "2024-05-22T22:24:31.3062901Z",
277+
"datacontenttype": "application/json",
278+
"specversion": "1.0",
279+
"data": {
280+
"@odata.type": "#Microsoft.OutlookServices.Notification",
281+
"Id": null,
282+
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
283+
"ChangeType": "deleted",
284+
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
285+
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
286+
"clientState": "<client state>",
287+
"resourceData": {
288+
"Id": "<message id>",
289+
"@odata.etag": "<tag id>",
290+
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
291+
"@odata.type": "#Microsoft.OutlookServices.Message",
292+
"OtherResourceData": "<some other resource data>"
293+
}
294+
}
295+
}
296+
```
297+
205298
## Event properties
206299

207300
An event has the following top-level data:

articles/event-grid/partner-events-graph-api.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Microsoft Graph API events in Azure Event Grid
33
description: This article describes events published by Microsoft Graph API.
44
ms.topic: conceptual
5-
ms.date: 06/09/2022
5+
ms.date: 05/22/2024
66
---
77

88
# Microsoft Graph API events
@@ -11,6 +11,7 @@ Microsoft Graph API provides a unified programmable model that you can use to re
1111

1212
## Graph API event sources
1313

14+
1415
|Microsoft event source |Resource(s) | Available event types |
1516
|:--- | :--- | :----|
1617
| Microsoft Entra ID | [User](/graph/api/resources/user), [Group](/graph/api/resources/group) | [Microsoft Entra event types](microsoft-entra-events.md) |

articles/event-grid/subscribe-to-graph-api-events.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,27 @@ author: robece
55
ms.author: robece
66
ms.topic: how-to
77
ms.custom: devx-track-azurecli, devx-track-azurepowershell, devx-track-extended-java, devx-track-go, devx-track-js, devx-track-python, build-2024
8-
ms.date: 12/08/2023
8+
ms.date: 05/22/2024
99
---
1010

1111
# Receive Microsoft Graph API change events through Azure Event Grid
1212

1313
This article describes steps to subscribe to events published by Microsoft Graph API. The following table lists the event sources for which events are available through Graph API. For most resources, events announcing its creation, update, and deletion are supported. For detailed information about the resources for which events are raised for event sources, see [supported resources by Microsoft Graph API change notifications](/graph/webhooks#supported-resources)
1414
.
1515

16-
|Microsoft event source |Available event types |
17-
|:--- | :----|
18-
|Microsoft Entra ID| [Microsoft Entra event types](azure-active-directory-events.md) |
19-
|Microsoft Outlook| [Microsoft Outlook event types](outlook-events.md) |
20-
|Microsoft 365 group conversations ||
21-
|Microsoft Teams| [Microsoft Teams event types](teams-events.md) |
22-
|Microsoft SharePoint and OneDrive| |
23-
|Microsoft SharePoint| |
24-
|Security alerts| |
25-
|Microsoft Conversations| |
26-
|Microsoft Universal Print||
16+
|Microsoft event source |Resource(s) | Available event types |
17+
|:--- | :--- | :----|
18+
| Microsoft Entra ID | [User](/graph/api/resources/user), [Group](/graph/api/resources/group) | [Microsoft Entra event types](microsoft-entra-events.md) |
19+
| Microsoft Outlook|[Event](/graph/api/resources/event) (calendar meeting), [Message](/graph/api/resources/message) (email), [Contact](/graph/api/resources/contact) | [Microsoft Outlook event types](outlook-events.md) |
20+
| Microsoft Teams |[ChatMessage](/graph/api/resources/callrecords-callrecord), [CallRecord](/graph/api/resources/callrecords-callrecord) (meeting) | [Microsoft Teams event types](teams-events.md) |
21+
| OneDrive | [DriveItem](/graph/api/resources/driveitem)| [Microsoft OneDrive events](one-drive-events.md) |
22+
| Microsoft SharePoint | [List](/graph/api/resources/list) | [Microsoft SharePoint events](share-point-events.md) |
23+
| To Do | [To Do Task](/graph/api/resources/todotask) | [Microsoft ToDo events](to-do-events.md) |
24+
| Security alerts | [Alert](/graph/api/resources/alert)| [Microsoft Security Alert events](security-alert-events.md) |
25+
| Cloud printing | [Printer](/graph/api/resources/printer), [Print Task Definition](/graph/api/resources/printtaskdefinition) | [Microsoft Cloud Printing events](cloud-printing-events.md) |
26+
| Microsoft Conversations | [Conversation](/graph/api/resources/conversation) | [Microsoft 365 Group Conversation events](conversation-events.md) |
27+
28+
You create a Microsoft Graph API subscription to enable Graph API events to flow into a partner topic. The partner topic is automatically created for you as part of the Graph API subscription creation. You use that partner topic to [create event subscriptions](event-filtering.md) to send your events to any of the supported [event handlers](event-handlers.md) that best meets your requirements to process the events.
2729

2830
> [!IMPORTANT]
2931
>If you aren't familiar with the **Partner Events** feature, see [Partner Events overview](partner-events-overview.md).

0 commit comments

Comments
 (0)