PushSubscriptionRequest

Article
03/29/2023

The PushSubscriptionRequest element represents a subscription to a push-based event notification subscription.

<PushSubscriptionRequest SubscribeToAllFolders="">
   <FolderIds/>
   <EventTypes/>
   <Watermark/>
   <StatusFrequency/>
   <URL/>
</PushSubscriptionRequest>

PushSubscriptionRequestType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
SubscribeToAllFolders	Indicates whether to subscribe to all available folders. This attribute is optional.

Child elements

Element	Description
FolderIds	Contains an array of folder identifiers that are used to identify folders to monitor for event notifications.
EventTypes	Contains a collection of event notifications that are used to create a subscription.
Watermark	Represents an event bookmark in the mailbox events table. This is used to create a subscription starting at an event represented by the watermark. If the watermark from a Subscribe request is not found, an error response will be returned to the client. This may occur if the watermark is older than 30 days or if the watermark was never present in the mailbox.
StatusFrequency	Represents the frequency, specified in minutes, at which notification messages will be sent to the client when no events have occurred.
Url	Represents the location of the client Web service for push notifications.

Parent elements

Element	Description
Subscribe	Contains the properties used to create subscriptions.

Text value

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

Element information

Name	Value
Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
Schema name	Messages schema
Validation file	Messages.xsd
Can be empty	False