You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: This article describes Microsoft Outlook events in Azure Event Grid.
4
4
ms.topic: conceptual
5
-
ms.date: 06/09/2022
5
+
ms.date: 05/22/2024
6
6
---
7
7
8
8
# Microsoft Outlook events
9
9
10
-
This article provides the properties and schema for Microsoft Outlook events, which are published by Microsoft Graph API. For an introduction to event schemas, see [CloudEvents schema](cloud-event-schema.md).
10
+
This article provides the properties and schema for Microsoft Outlook events that the Microsoft Graph API publishes. For an introduction to event schemas, see [CloudEvents schema](cloud-event-schema.md).
11
11
12
12
## Available event types
13
-
These events are triggered when an Outlook event or an Outlook contact is created, updated or deleted or by operating over those resources using Microsoft Graph API.
14
13
15
14
| Event name | Description |
16
15
| ---------- | ----------- |
@@ -20,6 +19,10 @@ These events are triggered when an Outlook event or an Outlook contact is create
20
19
|**Microsoft.Graph.ContactCreated**| Triggered when a contact in Outlook is created. |
21
20
|**Microsoft.Graph.ContactUpdated**| Triggered when a contact in Outlook is updated. |
22
21
|**Microsoft.Graph.ContactDeleted**| Triggered when a contact in Outlook is deleted. |
22
+
|**Microsoft.Graph.MessageCreated**| Triggered when a message in Outlook is created. |
23
+
|**Microsoft.Graph.MessageUpdated**| Triggered when a message in Outlook is updated. |
24
+
|**Microsoft.Graph.MessageDeleted**| Triggered when a message in Outlook is deleted. |
25
+
23
26
24
27
## Example event
25
28
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 +35,13 @@ When an event is triggered, the Event Grid service sends data about that event t
@@ -230,12 +322,12 @@ The data object has the following properties:
230
322
|`@odata.id`| string | The Graph API resource identifier for which the event was raised. |
231
323
|`id`| string | The resource identifier for which the event was raised. |
232
324
|`organizationId`| string | The Outlook tenant identifier. |
233
-
|`eventTime`| string | The time at which the resource state occurred. |
325
+
|`eventTime`| string | The time when the resource state occurred. |
234
326
|`sequenceNumber`| string | A sequence number. |
235
-
|`subscriptionExpirationDateTime`| string | The time in [RFC 3339](https://tools.ietf.org/html/rfc3339) format at which the Graph API subscription expires. |
327
+
|`subscriptionExpirationDateTime`| string | The time in [Request for Change (RFC) 3339](https://tools.ietf.org/html/rfc3339) format at which the Graph API subscription expires. |
236
328
|`subscriptionId`| string | The Graph API subscription identifier. |
237
329
|`tenantId`| string | The Outlook tenant identifier. |
238
-
|`otherResourceData`| string | Placeholder that represents one or more dynamic properties that may be included in the event. |
330
+
|`otherResourceData`| string | Placeholder that represents one or more dynamic properties that might be included in the event. |
239
331
240
332
241
333
## Next steps
@@ -244,4 +336,4 @@ The data object has the following properties:
244
336
* For information on how to subscribe to Microsoft Graph API to receive Outlook events, see [subscribe to Azure Graph API events](subscribe-to-graph-api-events.md).
245
337
* For information about Azure Event Grid event handlers, see [event handlers](event-handlers.md).
246
338
* For more information about creating an Azure Event Grid subscription, see [create event subscription](subscribe-through-portal.md#create-event-subscriptions) and [Event Grid subscription schema](subscription-creation-schema.md).
247
-
* For information about how to configure an event subscription to select specific events to be delivered, consult [event filtering](event-filtering.md). You may also want to refer to [filter events](how-to-filter-events.md).
339
+
* For information about how to configure an event subscription to select specific events to be delivered, consult [event filtering](event-filtering.md). You might also want to refer to [filter events](how-to-filter-events.md).
Copy file name to clipboardExpand all lines: articles/event-grid/partner-events-graph-api.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,16 +2,17 @@
2
2
title: Microsoft Graph API events in Azure Event Grid
3
3
description: This article describes events published by Microsoft Graph API.
4
4
ms.topic: conceptual
5
-
ms.date: 06/09/2022
5
+
ms.date: 05/22/2024
6
6
---
7
7
8
8
# Microsoft Graph API events
9
9
10
-
Microsoft Graph API provides a unified programmable model that you can use to receive events about state changes of resources in Microsoft Outlook, Teams, SharePoint, Microsoft Entra ID, Microsoft Conversations, and security alerts. For every resource in the following table, events for create, update and delete state changes are supported.
10
+
Microsoft Graph API provides a unified programmable model that you can use to receive events about state changes of resources in Microsoft Outlook, Teams, SharePoint, Microsoft Entra ID, Microsoft Conversations, and security alerts. For every resource in the following table, events for create, update, and delete state changes are supported.
11
11
12
12
## Graph API event sources
13
13
14
-
|Microsoft event source |Resource(s) | Available event types |
14
+
15
+
|Microsoft event source |Resources | Available event types |
15
16
|:--- | :--- | :----|
16
17
| Microsoft Entra ID |[User](/graph/api/resources/user), [Group](/graph/api/resources/group)|[Microsoft Entra event types](microsoft-entra-events.md)|
17
18
| 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)|
# Receive Microsoft Graph API change events through Azure Event Grid
12
12
13
13
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)
|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 |Resources | 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)|
| 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.
27
29
28
30
> [!IMPORTANT]
29
31
>If you aren't familiar with the **Partner Events** feature, see [Partner Events overview](partner-events-overview.md).
-`changeType`: the kind of resource changes for which you want to receive events. Valid values: `Updated`, `Deleted`, and `Created`. You can specify one or more of these values separated by commas.
125
-
-`notificationUrl`: a URI used to define the partner topic to which events are sent. It must conform to the following pattern: `EventGrid:?azuresubscriptionid=<you-azure-subscription-id>&resourcegroup=<your-resource-group-name>&partnertopic=<the-name-for-your-partner-topic>&location=<the-Azure-region-name-where-you-want-the-topic-created>`. The location (also known as Azure region) `name` can be obtained by executing the **az account list-locations** command. Don't use a location display name. For example, don't use "West Central US". Use `westcentralus` instead.
127
+
-`notificationUrl`: a URI used to define the partner topic to which events are sent. It must conform to the following pattern: `EventGrid:?azuresubscriptionid=<you-azure-subscription-id>&resourcegroup=<your-resource-group-name>&partnertopic=<the-name-for-your-partner-topic>&location=<the-Azure-region-name-where-you-want-the-topic-created>`. The location (also known as Azure region) `name` can be obtained by executing the **az account list-locations** command. Don't use a location display name. For example, don't use West Central US. Use `westcentralus` instead.
126
128
```azurecli-interactive
127
129
az account list-locations
128
130
```
129
131
-`lifecycleNotificationUrl`: a URI used to define the partner topic to which `microsoft.graph.subscriptionReauthorizationRequired`events are sent. This event signals your application that the Graph API subscription is expiring soon. The URI follows the same pattern as *notificationUrl* described earlier if using Event Grid as destination to lifecycle events. In that case, the partner topic should be the same as the one specified in *notificationUrl*.
130
132
- resource: the resource that generates events that announce state changes.
131
-
- expirationDateTime: the expiration time at which the subscription expires and the flow of events stop. It must conform to the format specified in [RFC 3339](https://tools.ietf.org/html/rfc3339). You must specify an expiration time that is within the [maximum subscription length allowable per resource type](/graph/api/resources/subscription#subscription-lifetime).
133
+
- expirationDateTime: the expiration time at which the subscription expires and the flow of events stop. It must conform to the format specified in [Request for Change (RFC) 3339](https://tools.ietf.org/html/rfc3339). You must specify an expiration time that is within the [maximum subscription length allowable per resource type](/graph/api/resources/subscription#subscription-lifetime).
132
134
- client state. This property is optional. It's used for verification of calls to your event handler application during event delivery. For more information, see [Graph API subscription properties](/graph/api/resources/subscription#properties).
0 commit comments