userPurpose resource type

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.

The purpose of the mailbox. Used to differentiate a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online.


Property Type Description
value mailboxRecipientType Represents the user's recipient or mailbox type in Exchange Online. Possible values are: unknown, user, linked, shared, room, equipment, and others. See the next section for more information.

mailboxRecipientType values

Member Description
unknown No information found about the mailbox.
user A user account with a mailbox in the local forest.
linked A mailbox linked to a user account in another forest.
shared A mailbox shared by two or more user accounts.
room A mailbox representing a conference room.
equipment A mailbox representing a piece of equipment.
others Mailbox found but user purpose is different from the ones specified above.

JSON representation

Here is a JSON representation of the resource.

    "value": "string"