Update subscription

Renew a subscription by extending its expiry time.

Subscriptions to resources expire at dates proscribed by the individual resource types. In order not to miss notifications, subscriptions should be renewed well in advance of their expiry date. See subscription for individual expiry dates.


The following table lists the suggested permission needed for each resource.

Resource type / Item Scope
Contacts Contacts.Read
Conversations Group.Read.All
Events Calendars.Read
Messages Mail.Read
Drive (User's OneDrive) Files.ReadWrite
Drives (Sharepoint shared content and drives) Files.ReadWrite.All

HTTP request

PATCH /subscriptions/{subscriptionId}

Request headers

Name Type Description
Authorization string Bearer {token}. Required.


If successful, this method returns a 200 OK response code and subscription object in the response body.



Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/subscriptions/{subscriptionId}
Content-type: application/json


Here is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 252