Create browserSharedCookie

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Create a new browserSharedCookie object in a browserSiteList.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) BrowserSiteLists.ReadWrite.All
Delegated (personal Microsoft account) Not supported.
Application BrowserSiteLists.ReadWrite.All

HTTP request

POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies

Request headers

Name Description
Authorization Bearer {token}. Required.
Content-Type application/json. Required.

Request body

In the request body, supply a JSON representation of the browserSharedCookie object.

You can specify the following properties when you create a browserSharedCookie.

Property Type Description
comment String The comment of the cookie. Required.
displayName String The name of the cookie. Required.
hostOnly Boolean Determines whether a cookie is a host-only or domain cookie. Required.
hostOrDomain String The URL of the cookie. Required.
path String The path of the cookie. Required.
sourceEnvironment browserSharedCookieSourceEnvironment Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: microsoftEdge, internetExplorer11, both, unknownFutureValue. Required.


If successful, this method returns a 201 Created response code and a browserSharedCookie object in the response body.



The following is an example of a request.

Content-Type: application/json

    "@odata.type": "#microsoft.graph.browserSharedCookie",
    "hostOrDomain": "",
    "sourceEnvironment": "InternetExplorer11",
    "displayName": "Microsoft Cookie",
    "hostOnly": true,
    "comment": "A cookie for",
    "path": "/"


The following is an example of the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

    "status": "pendingAdd",
    "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141",
    "hostOrDomain": "",
    "sourceEnvironment": "internetExplorer11",
    "displayName": "Microsoft Cookie",
    "path": "/",
    "hostOnly": true,
    "comment": "A cookie for",
    "lastModifiedDateTime": "2022-06-29T15:32:39.6732721Z",
    "createdDateTime": "2022-06-29T15:32:39.673272Z",
    "deletedDateTime": null,
    "lastModifiedBy": {
        "user": {
            "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
            "displayName": "Joe Smith"
        "application": null
    "history": []