MailboxConfigItem.ReadWrite
Allows the app to create, read, update and delete all users' UserConfiguration objects.
Permission Details
Read and write all users' UserConfiguration objects
Allows the app to create, read, update and delete all users' UserConfiguration objects.
aa6d92d4-b25a-4640-aefe-3e3231e5e736
Read and write user's UserConfiguration objects
Allows the app to create, read, update and delete user's UserConfiguration objects, on behalf of the the signed-in user.
7d461784-7715-4b09-9f90-91a6d8722652
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
childFolderCount |
Int32Nullable |
The number of immediate child mailFolders in the current mailFolder. |
displayName |
StringNullable |
The mailFolder's display name. |
id |
String |
The mailFolder's unique identifier. |
isHidden |
BooleanNullable |
Indicates whether the mailFolder is hidden. This property can be set only when creating the folder. Find more information in Hidden mail folders. |
parentFolderId |
StringNullable |
The unique identifier for the mailFolder's parent mailFolder. |
totalItemCount |
Int32Nullable |
The number of items in the mailFolder. |
unreadItemCount |
Int32Nullable |
The number of items in the mailFolder marked as unread. |
childFolders |
mailFolder collection |
The collection of child folders in the mailFolder. |
messageRules |
messageRule collection |
The collection of rules that apply to the user's Inbox folder. |
messages |
message collection |
The collection of messages in the mailFolder. |
multiValueExtendedProperties |
multiValueLegacyExtendedProperty collection |
The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable. |
singleValueExtendedProperties |
singleValueLegacyExtendedProperty collection |
The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"childFolderCount": 1024,
"displayName": "string",
"id": "string (identifier)",
"parentFolderId": "string",
"totalItemCount": 1024,
"unreadItemCount": 1024,
"isHidden": false,
"childFolders": [
{
"@odata.type": "microsoft.graph.mailFolder"
}
],
"messageRules": [
{
"@odata.type": "microsoft.graph.messageRule"
}
],
"messages": [
{
"@odata.type": "microsoft.graph.message"
}
],
"multiValueExtendedProperties": [
{
"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"
}
],
"singleValueExtendedProperties": [
{
"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"
}
]
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
childFolders |
MailFolder collection |
The collection of child folders in the mailFolder. |
messageRules |
messageRule collection |
The collection of rules that apply to the user's Inbox folder. |
messages |
Message collection |
The collection of messages in the mailFolder. |
multiValueExtendedProperties |
multiValueLegacyExtendedProperty collection |
The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable. |
singleValueExtendedProperties |
singleValueLegacyExtendedProperty collection |
The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable. |
operations |
mailFolderOperation collection |
The collection of long-running operations in the mailFolder. |
userConfigurations |
userConfiguration collection |
The user configuration objects associated to the mailFolder. |
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.
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
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.MailFolders["{mailFolder-id}"].UserConfigurations["{userConfiguration-id}"].GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
const userConfiguration = {
id: 'MyApp',
binaryData: 'SGVsbG8=',
xmlData: 'V29ybGQ=',
structuredData: [
{
keyEntry: {
type: 'byte',
values: [
'100'
]
},
valueEntry: {
type: 'boolean',
values: [
'true'
]
}
},
{
keyEntry: {
type: 'integer32',
values: [
'-32'
]
},
valueEntry: {
type: 'integer64',
values: [
'64'
]
}
},
{
keyEntry: {
type: 'unsignedInteger32',
values: [
'32'
]
},
valueEntry: {
type: 'unsignedInteger64',
values: [
'64'
]
}
},
{
keyEntry: {
type: 'string',
values: [
'DateTime'
]
},
valueEntry: {
type: 'dateTime',
values: [
'2025-10-23T01:23:45.0000000+00:00'
]
}
},
{
keyEntry: {
type: 'byteArray',
values: [
'AQECAwUI'
]
},
valueEntry: {
type: 'stringArray',
values: [
'Hello',
'World'
]
}
}
]
};
await client.api('/me/mailFolders/inbox/userConfigurations')
.version('beta')
.post(userConfiguration);
Import-Module Microsoft.Graph.Beta.Mail
# A UPN can also be used as -UserId.
Get-MgBetaUserMailFolderUserConfiguration -UserId $userId -MailFolderId $mailFolderId -UserConfigurationId $userConfigurationId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.me.mail_folders.by_mail_folder_id('mailFolder-id').user_configurations.by_user_configuration_id('userConfiguration-id').get()
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 MailboxConfigItem.ReadWrite
Grant Admin Consent
Application permissions always require admin consent.