Notification-Type Header

The WebDAV Notification-Type header specifies the type of event that is to be monitored in a subscription. There are several different events that can be monitored: deletes, moves, updates, new mail, and new members. Subscriptions for delete events will fire notifications whenever resources are deleted within the scope of the subscription. This does not apply to the removal of properties. Subscriptions for move events are generated when resources or collections are moved within the scope of the subscription. Update events consist of any change to resources within the scope of a subscription. The other subscriptions are a subset of the update event. New mail notifications are fired when mail arrives in the subscribed collection resource, and new member notifications are generated when creating resources within the scope of the subscription. Together, these different events allow a system to monitor general changes to the state of the server and to respond accordingly.

Notification-Type := "notification-type:" ntype
ntype := "update"  |
"update/newmember" |
"delete" |
"move" |
"pragma/<https://schemas.microsoft.com/exchange/newmail>"

The Notification-Type header must appear in a new SUBSCRIBE Method. This header should not appear in a SUBSCRIBE Method if the Subscription-ID Header is renewing a subscription.

The Notification-Type header must appear in a 200 (OK) response to a SUBSCRIBE Method if anything in the notification-type or delivery control changed.

There can be no spaces anywhere in the Notification-Type header.

If a Delete notification is registered on an inbox or the Sent Items folder and Microsoft® Outlook® or Outlook Web Access is used to delete a message in the inbox, a Delete notification is not raised. This is because Outlook and Outlook Web Access move messages from the Inbox to the Deleted Items folder rather than deleting them.

If a user subscribes to a folder and that folder is later deleted or renamed, then the subscription is lost and the subscription ID becomes invalid. The POLL Method will then fail with a 412 (Precondition Failed) response. It is the client's responsibility to watch for the 412 (Precondition Failed) response and to verify that a folder resource still exists.

If a pragma/<https://schemas.microsoft.com/exchange/newmail> notification is registered on a public folder and a message is posted to that public folder, the notification will not be raised.

The following table contains information about the different events that can be specified in the Notification-Type header.