Share via

Microsoft Graph Equivalent of EWS Contact Groups / Personal Distribution Lists

Baljeet Kaur 0 Reputation points
2026-05-29T11:40:40.4433333+00:00
  1. Does Microsoft Graph currently support creating Outlook personal contact groups / distribution lists similar to EWS?
  2. Can mailbox contacts (contact inside contactFolder) be added to:
    • Microsoft 365 Groups
    • Distribution Groups
    • Mail-enabled Security Groups
    • nested groups
  3. Is there any supported API for:
    • reference-based contact memberships
    • reusable mailbox contact references
    • many-to-many contact-folder relationships
    • linked/shared mailbox contacts
  4. Is the current understanding correct that:
    • mailbox contacts are not directoryObject
    • Graph groups only support directory objects
    • Outlook personal contact groups are not properly exposed through Graph APIs
  5. What is the officially recommended migration path from EWS for Outlook Contact Groups?
  6. Are there any roadmap items, preview APIs, or future plans for:
    • Outlook personal contact group APIs
    • mailbox contact memberships
    • reusable mailbox contact references

We tested Microsoft 365 Group creation using Graph successfully, but mailbox contacts could not be added as members and the behavior appears different from EWS-based Outlook Contact Groups.

Could Microsoft confirm the current supported capabilities and recommended architecture for this scenario?

Microsoft Security | Microsoft Graph
0 comments No comments

2 answers

Sort by: Most helpful
  1. Vasil Michev 127K Reputation points MVP Volunteer Moderator
    2026-05-29T12:23:57.3566667+00:00

    There is no replacement for Outlook contact groups in the Graph, and Microsoft has not announced any plans to address this gap. I wouldn't hold my breath, given the deadline is just few months away now.

    Best you can do currently is work with the "raw" items via the Graph Import/Export API, see this blog post by Glen: https://glenscales.substack.com/p/migrating-personal-distribution-lists

    Was this answer helpful?


  2. AI answer

    2026-05-29T11:41:07.13+00:00
    1. Microsoft Graph does not expose an Outlook personal contact-group / personal distribution-list resource equivalent to the EWS contact-group object. The Outlook contacts API in Microsoft Graph supports CRUD on individual contact items and contactFolder objects, but the context does not document any API for creating or managing personal contact groups as first-class objects.
    2. Group membership in Microsoft Graph is limited to directory objects as defined for Microsoft 365 and security groups:
      • Supported member types are: user, security group, device, service principal, and organizational contact, depending on the group type.
      • Microsoft 365 groups and security groups do not accept Outlook mailbox contact items (from contactFolder) as members.
      • The membership matrix explicitly shows that only directory objects (user, security group, device, service principal, organizational contact) can be members; mailbox contacts are not listed and therefore not supported as members.
      • Nested group membership is supported only for security groups (a security group can be a member of another security group). Microsoft 365 groups cannot contain other groups as members.
      Specifically:
      • Microsoft 365 Groups: can contain users as members; cannot contain security groups, Microsoft 365 groups, devices, service principals, or organizational contacts as members.
      • Security Groups: can contain users, security groups, devices, service principals, and organizational contacts as members.
      • Distribution groups and mail‑enabled security groups are read‑only in Microsoft Graph; membership changes are not supported via Graph.
    3. The context does not document any supported Microsoft Graph API for:
      • reference-based contact memberships
      • reusable mailbox contact references
      • many-to-many contact-folder relationships
      • linked/shared mailbox contacts beyond standard sharing/delegation semantics
      The Outlook contacts API supports:
      • CRUD on contact and contactFolder
      • categories, flags (preview), photos, open and schema extensions
      • access to contacts in the signed-in user’s mailbox and in shared/delegated mailboxes
      But it does not describe any model where contacts are referenced as reusable membership objects across groups or folders.
    4. The following understanding is consistent with the provided context:
      • Mailbox contacts are not directoryObject instances. The context only lists directory-based objects (user, device, service principal, organizational contact, groups) as valid group members; mailbox contacts are treated as Outlook items in a mailbox, not as Entra ID directory objects.
      • Graph groups only support directory objects as members. The membership table for Microsoft 365 and security groups lists only directory objects as valid members.
      • Outlook personal contact groups are not documented as being exposed through Microsoft Graph APIs. The Outlook contacts overview describes contact and contactFolder, but not personal contact-group constructs.
    5. The context does not provide an official, prescriptive migration path from EWS contact groups to an equivalent Microsoft Graph feature. It only provides an EWS→Graph mapping table for Groups-related EWS APIs, and those mappings target Microsoft 365 groups and their directory-based membership, not personal contact groups. The documented mappings show how to move from EWS “Unified Groups” operations (for Microsoft 365 groups) to Graph (for example, GetUserUnifiedGroupsuser-list-memberof, CreateUnifiedGroupgroup-post-groups), but there is no mapping for EWS personal contact-group APIs.
    6. The context does not mention any roadmap items, preview APIs, or future plans for:
      • Outlook personal contact group APIs
      • mailbox contact memberships as group members
      • reusable mailbox contact references
      The Outlook contacts API overview and the groups overview focus on existing capabilities only; no future or preview features in these areas are described.

    Given the provided information, the supported architecture in Microsoft Graph for group-like constructs is based on Microsoft 365 groups and security groups with directory-object membership, plus independent Outlook contact items and contactFolder organization. Personal contact groups implemented as mailbox-level distribution lists are not represented as first-class, group-member-manageable resources in Microsoft Graph.


    References:

    AI-generated content may be incorrect. Read our transparency notes for more information.

    Was this answer helpful?

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.