What email address type is supposed in ms graph api v1

Question

Hello,

Context: classic outlook (M365) requires address type for MAPI Recipient in order to display email address (when clicking "displayName" on recipient field the "emailAddress" showed as contact). If set this property to "SMTP" all is okay, but:

in ms graph api v1: emailAddress resource type: [address type] is not mentioned, also there is no a property for that

• v1: https://learn.microsoft.com/en-us/graph/api/resources/emailaddress?view=graph-rest-1.0

for beta version there is implicit "SMTP" type mentioned in description.

• beta: https://learn.microsoft.com/en-us/graph/api/resources/emailaddress?view=graph-rest-beta

Questions:

• Is it possible to get the non-SMTP addresses type in graph api v1?
• If yes, how to distinguish those types?

Answer 1

Hi @Ilya Abramau

Thank you for reaching out via the Microsoft Q&A forum. 

Based on the information you shared, I understand you're trying to find a way to get the MAPI "address type" (specifically for non-SMTP addresses) from the Microsoft Graph API v1.0. You've correctly noted that the emailAddress resource in v1.0 doesn't seem to expose this, while the beta documentation implies an "SMTP" type.

You are correct in your observation. The emailAddress resource type in v1.0 does not explicitly support non-SMTP types. After researching this, I can provide direct answers to your two questions:

1. No. The emailAddress resource in v1.0 does not expose any address-type information and always treats the address field as an SMTP email address. Non-SMTP types used by classic Outlook/MAPI are not returned or distinguishable through this specific resource. When Graph returns recipients (e.g., in a message's toRecipients or ccRecipients), they are normalized to SMTP format.

2. Not applicable. As stated above, there is no way to distinguish types in v1.0 because the type of information simply isn't included in the emailAddress resource.

However, I did find a workaround. You can retrieve non-SMTP address types in Microsoft Graph API v1.0 by querying the proxyAddresses property. This property is available on supported resources like the user resource type (which is the most common case), as well as on group and organization contact resources.

The proxyAddresses property returns a list of all email addresses associated with a mailbox, and it does include the prefixes for non-SMTP addresses. This property is read-only in the Graph API. (Updates must be made via the Microsoft 365 Admin Center or Exchange tools). It supports OData query parameters like $filter.

I recommend you explore using this property. You can find more information in the documentation for the user resource here:

• How the proxyAddresses attribute is populated in Microsoft Entra ID

I hope this information can help you to solve it. 

Wish you a pleasant day! 

---

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".     

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.