PushSubscriptionRequest

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

Subscribe

PushSubscriptionRequest

<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
http://schemas.microsoft.com/exchange/services/2006/messages
Schema name
Messages schema
Validation file
Messages.xsd
Can be empty
False

See also

Subscribe operation

GetEvents operation

Unsubscribe operation