Skip to content

spo list webhook add

Adds a new webhook to the specified list

Usage

m365 spo list webhook add [options]

Options

-u, --webUrl <webUrl>
URL of the site where the list is located.
-l, --listId [listId]
ID of the list. Specify either listTitle, listId or listUrl.
-t, --listTitle [listTitle]
Title of the list. Specify either listTitle, listId or listUrl.
--listUrl [listUrl]
Server- or site-relative URL of the list. Specify either listTitle, listId or listUrl.
-n, --notificationUrl <notificationUrl>
The notification URL.
-e, --expirationDateTime [expirationDateTime]
The expiration date. Will be set to max (6 months from today) if not provided.
-c, --clientState [clientState]
A client state information that will be passed through notifications.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Add a web hook to the list retrieved by Title located in a specific site with a specific notification url and the default expiration date

m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --notificationUrl https://contoso-funcions.azurewebsites.net/webhook

Add a web hook to the list retrieved by URL located in a specific site with a specific notification url and a specific expiration date

m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime 2019-01-21

Add a web hook to the list retrieved by ID located in a specific site with a specific notification url, a specific expiration date and a client state

m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listId '3d6aefa0-f438-4789-b0cd-6e865f5d65b5' --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime '2019-03-02T18:15' --clientState "Hello State!"

Response

{
  "clientState": "random client state",
  "expirationDateTime": "2019-05-29T23:00:00.000Z",
  "id": "ef69c37d-cb0e-46d9-9758-5ebdeffd6959",
  "notificationUrl": "https://contoso-funcions.azurewebsites.net/webhook",
  "resource": "0987cfd9-f02c-479b-9fb4-3f0550462848",
  "resourceData": null
}
clientState       : random client state
expirationDateTime: 2019-05-29T23:00:00.000Z
id                : ef69c37d-cb0e-46d9-9758-5ebdeffd6959
notificationUrl   : https://contoso-funcions.azurewebsites.net/webhook
resource          : 0987cfd9-f02c-479b-9fb4-3f0550462848
resourceData      : null
clientState,expirationDateTime,id,notificationUrl,resource,resourceData
random client state,2019-05-29T23:00:00.000Z,ef69c37d-cb0e-46d9-9758-5ebdeffd6959,https://contoso-funcions.azurewebsites.net/webhook,0987cfd9-f02c-479b-9fb4-3f0550462848,
# spo list webhook add --webUrl "https://contoso.sharepoint.com/sites/ninja" --listUrl "/sites/ninja/Documents" --notificationUrl "https://contoso-funcions.azurewebsites.net/webhook" --expirationDateTime "2019-01-21"

Date: 2/20/2023

## ef69c37d-cb0e-46d9-9758-5ebdeffd6959

Property | Value
---------|-------
clientState | random client state
expirationDateTime | 2019-05-29T23:00:00.000Z
id | ef69c37d-cb0e-46d9-9758-5ebdeffd6959
notificationUrl | https://contoso-funcions.azurewebsites.net/webhook
resource | 0987cfd9-f02c-479b-9fb4-3f0550462848
resourceData | null