MailTips.ReadBasic.Shared | Graph Permissions

Permission Details

Delegated Permission

Read mail tips for mailboxes you can access

Allows the app to read mail tips on behalf of the signed-in user for mailboxes they have access to. Mail tips include automatic replies, mailbox status, custom tips, and delivery information.

Permission ID: 4776cae1-54bd-4dfd-823c-e5861ed49a98

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`automaticReplies`	`automaticRepliesMailTips`	Mail tips for automatic reply if it has been set up by the recipient.
`customMailTip`	`String`	A custom mail tip that can be set on the recipient's mailbox.
`deliveryRestricted`	`Boolean`	Whether the recipient's mailbox is restricted, for example, accepting messages from only a predefined list of senders, rejecting messages from a predefined list of senders, or accepting messages from only authenticated senders.
`emailAddress`	`emailAddress`	The email address of the recipient to get mailtips for.
`error`	`mailTipsError`	Errors that occur during the getMailTips action.
`externalMemberCount`	`Int32`	The number of external members if the recipient is a distribution list.
`isModerated`	`Boolean`	Whether sending messages to the recipient requires approval. For example, if the recipient is a large distribution list and a moderator has been set up to approve messages sent to that distribution list, or if sending messages to a recipient requires approval of the recipient's manager.
`mailboxFull`	`Boolean`	The mailbox full status of the recipient.
`maxMessageSize`	`Int32`	The maximum message size that has been configured for the recipient's organization or mailbox.
`recipientScope`	`recipientScopeType`	The scope of the recipient. The possible values are: none, internal, external, externalPartner, externalNonParther. For example, an administrator can set another organization to be its "partner". The scope is useful if an administrator wants certain mailtips to be accessible to certain scopes. It's also useful to senders to inform them that their message may leave the organization, helping them make the correct decisions about wording, tone and content.
`recipientSuggestions`	`recipient collection`	Recipients suggested based on previous contexts where they appear in the same message.
`totalMemberCount`	`Int32`	The number of members if the recipient is a distribution list.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "automaticReplies": {
    "@odata.type": "microsoft.graph.automaticRepliesMailTips"
  },
  "customMailTip": "string",
  "deliveryRestricted": "boolean",
  "emailAddress": {
    "@odata.type": "microsoft.graph.emailAddress"
  },
  "error": {
    "@odata.type": "microsoft.graph.mailTipsError"
  },
  "externalMemberCount": 1024,
  "isModerated": "boolean",
  "mailboxFull": "boolean",
  "maxMessageSize": 1024,
  "recipientScope": "string",
  "recipientSuggestions": [
    {
      "@odata.type": "microsoft.graph.recipient"
    }
  ],
  "totalMemberCount": 1024
}

Relationships

Relationships metadata is not available for this permission mapping.

View resource documentation

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/me/getMailTips`
POST `/users/{id\|userPrincipalName}/getMailTips`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/me/getMailTips`
POST `/users/{id\|userPrincipalName}/getMailTips`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgUserMailTip` /me/getMailTips user: getMailTips

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaUserMailTip` /me/getMailTips user: getMailTips

Code Examples

C# / .NET SDK

user: getMailTips

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Me.GetMailTips;
using Microsoft.Graph.Models;

var requestBody = new GetMailTipsPostRequestBody
{
	EmailAddresses = new List<string>
	{
		"[email protected]",
		"[email protected]",
	},
	MailTipsOptions = MailTipsType.AutomaticReplies | MailTipsType.MailboxFullStatus,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.GetMailTips.PostAsGetMailTipsPostResponseAsync(requestBody);

JavaScript

user: getMailTips

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const mailTips = {
    EmailAddresses: [
        '[email protected]',
        '[email protected]'
    ],
    MailTipsOptions: 'automaticReplies, mailboxFullStatus'
};

await client.api('/me/getMailTips')
	.post(mailTips);

PowerShell

user: getMailTips

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Users.Actions

$params = @{
	EmailAddresses = @(
	"[email protected]"
"[email protected]"
)
MailTipsOptions = "automaticReplies, mailboxFullStatus"
}
# A UPN can also be used as -UserId.
Get-MgUserMailTip -UserId $userId -BodyParameter $params

Python

user: getMailTips

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.users.item.get_mail_tips.get_mail_tips_post_request_body import GetMailTipsPostRequestBody
from msgraph.generated.models.mail_tips_type import MailTipsType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = GetMailTipsPostRequestBody(
	email_addresses = [
		"[email protected]",
		"[email protected]",
	],
	mail_tips_options = MailTipsType.AutomaticReplies | MailTipsType.MailboxFullStatus,
)

result = await graph_client.me.get_mail_tips.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for MailTips.ReadBasic.Shared

4

Grant Admin Consent

Users can consent to this permission during sign-in.