This document provides information about SharePoint webhooks including code samples, documentation, community calls, case studies, and links to Microsoft Graph and Office 365 APIs. It describes how to create a webhook subscription to a SharePoint list using the REST API and receive notifications at a webhook endpoint. It also includes a diagram showing how the webhook notification is received and processed by storing the change token and notifying a webjob.

2. Code samples
Guidance documentation
Monthly community calls
Case Studies
SharePoint Framework
SharePoint add-ins
Microsoft Graph
Office 365 APIs
Sharing is caring…
http://aka.ms/SharePointPnP

4. HTTP/1.1 200 OK
Content-Type: text/plain
{randomString}
SharePoint
Service
POST /_api/web/lists('list-id')/subscriptions
Your application
POST https://{your host}/your/webhook/service
?validationtoken={randomString}
Your WebHook
notification service
endpoint
HTTP/1.1 201 Created
Your application
Content-Type: application/json
{
"resource": "https://contoso.sharepoint.com/_api/web/lists({id})",
"notificationUrl": "https://{your host}/your/webhook/service ",
"expirationDateTime": "2016-06-27T16:17:57+00:00"
}

5. HTTP/1.1 200 OK
SharePoint
Service
Your WebHook
notification service
endpoint
POST https://{your host}/your/webhook/service
{
"value":[
{
"subscriptionId":"91779246-afe9-4525-b122-6c199ae89211",
"clientState":"00000000-0000-0000-0000-000000000000",
"expirationDateTime":"2016-04-30T17:27:00.0000000Z",
"resource":"b9f6f714-9df8-470b-b22e-653855e1c181",
"tenantId":"00000000-0000-0000-0000-000000000000",
"siteUrl":"/",
"webId":"dbc5a806-e4d4-46e5-951c-6344d70b62fa"
}
]
}

6. Your WebHook
notification service
endpoint
SharePoint
Service
POST https://{your host}/your/webhook/service
Storage
Queue
WebJob
HTTP/1.1 200 OK

7. SharePoint
Service
WebHook creation: POST /_api/web/lists('list-id')/subscriptions
Your application
Grab “CurrentChangeToken” from list
Your WebHook
notification service
endpoint POST https://{your host}/your/webhook/service
Storage
Queue
WebJob
Grab change
token from
DB
Persis last used token
per subscription
SQL
Azure
DBPersis token per
subscription

11. https://ngrok.com/

12. http://culttt.com/2014/01/22/webhooks/
https://github.com/SharePoint/sp-dev-samples/tree/master/Samples/WebHooks.List.AzureAD
https://dev.office.com/sharepoint/docs/apis/webhooks/overview-sharepoint-webhooks
https://dev.office.com/sharepoint/docs/apis/webhooks/webhooks-reference-implementation
https://dev.office.com/sharepoint/docs/apis/webhooks/sharepoint-webhooks-using-azure-functions
https://dev.onedrive.com/webhooks/create-subscription.htm
https://github.com/OneDrive/onedrive-webhooks-aspnet
https://msdn.microsoft.com/office/office365/APi/notify-rest-operations
https://github.com/OfficeDev/PnP/tree/dev/Samples/OutlookNotificationsAPI.WebAPI