Sites.Create.All
Allow the application to create site collections without a signed in user. Upon creation the application will be granted Sites.Selected(application) + FullControl to the newly created site.
Permission Details
Create Site Collections without a signed in user.
Allow the application to create site collections without a signed in user. Upon creation the application will be granted Sites.Selected(application) + FullControl to the newly created site.
80819dd8-2b3b-4551-a1ad-2700fc44f533
Create Site Collections, on behalf of the signed-in user
Allow the application to create site collections on behalf of the signed in user. Upon creation the application will be granted Sites.Selected(delegated) + FullControl to the newly created site.
0e2e68e1-3f32-4e10-9281-f749e097fcbe
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
dataLocationCode |
string |
The geographic region code for where this site collection resides. Only present for multi-geo tenants. Read-only. |
hostname |
string |
The hostname for the site collection. Read-only. |
root |
[root][] |
If present, indicates that this is a root site collection in SharePoint. Read-only. |
archivalDetails |
[siteArchivalDetails][] |
Represents whether the site collection is recently archived, fully archived, or reactivating. The possible values are: recentlyArchived, fullyArchived, reactivating, unknownFutureValue. |
analytics |
object |
Analytics about the view activities that took place on this site. |
columns |
columnDefinition collection |
The collection of column definitions reusable across lists under this site. |
contentTypes |
contentType collection |
The collection of content types defined for this site. |
createdBy |
object |
Identity of the user, device, or application that created the item. Read-only. |
createdByUser |
object |
Identity of the user who created the item. Read-only. |
createdDateTime |
date-time |
Date and time of item creation. Read-only. |
description |
stringNullable |
Provides a user-visible description of the item. Optional. |
displayName |
stringNullable |
The full title for the site. Read-only. |
drive |
object |
The default drive (document library) for this site. |
drives |
drive collection |
The collection of drives (document libraries) under this site. |
error |
object |
Showing 15 of 36 properties.
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"hostname": "contoso.sharepoint.com",
"dataLocationCode": "EUR",
"root": {
"@odata.type": "microsoft.graph.root"
},
"archivalDetails": {
"@odata.type": "microsoft.graph.siteArchivalDetails",
"archiveStatus": "fullyArchived"
}
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
drive |
drive |
Default drive for the site. |
drives |
drive collection |
Document libraries under the site. |
lists |
list collection |
Lists under the site. |
sites |
site collection |
Subsites under the site. |
permissions |
permission collection |
Permissions associated with the site. |
columns |
columnDefinition collection |
The collection of column definitions reusable across lists under this site. |
contentTypes |
contentType collection |
The collection of content types defined for this site. |
externalColumns |
columnDefinition collection |
Related externalColumns data exposed by this resource. |
items |
baseItem collection |
Used to address any item contained in this site. This collection can't be enumerated. |
operations |
richLongRunningOperation collection |
The collection of long-running operations on the site. |
pages |
baseSitePage collection |
The collection of pages in the baseSitePages list in this site. |
termStores |
termStore.store collection |
The collection of termStores under this site. |
contentModels |
contentModel collection |
The collection of content models applied to this site. |
documentProcessingJobs |
documentProcessingJob collection |
The document processing jobs running on this site. |
extensions |
extension collection |
The collection of open extensions defined for this site. Nullable. |
pageTemplates |
pageTemplate collection |
The collection of page templates on this site. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
No API methods available for this version.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/sites/getOperationStatus(operationId='{siteOperationId}')
|
POST
/sites
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsCode Examples
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new Site
{
Name = "Communication Site Test",
WebUrl = "https://contoso.sharepoint.com/sites/commsite1",
Locale = "en-US",
ShareByEmailEnabled = false,
Description = "Test Site Description",
Template = SiteTemplateType.Sitepagepublishing,
OwnerIdentityToResolve = new IdentityInput
{
Email = "[email protected]",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Sites.PostAsync(requestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const site = {
name: 'Communication Site Test',
webUrl: 'https://contoso.sharepoint.com/sites/commsite1',
locale: 'en-US',
shareByEmailEnabled: false,
description: 'Test Site Description',
template: 'sitepagepublishing',
ownerIdentityToResolve: {
email: '[email protected]'
}
};
await client.api('/sites')
.version('beta')
.post(site);
Import-Module Microsoft.Graph.Beta.Sites
Get-MgBetaSiteOperationStatus -OperationId $operationIdId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.site import Site
from msgraph_beta.generated.models.site_template_type import SiteTemplateType
from msgraph_beta.generated.models.identity_input import IdentityInput
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Site(
name = "Communication Site Test",
web_url = "https://contoso.sharepoint.com/sites/commsite1",
locale = "en-US",
share_by_email_enabled = False,
description = "Test Site Description",
template = SiteTemplateType.Sitepagepublishing,
owner_identity_to_resolve = IdentityInput(
email = "[email protected]",
),
)
result = await graph_client.sites.post(request_body)
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for Sites.Create.All
Grant Admin Consent
Application permissions always require admin consent.