Synchronize Azure AD Groups to Yeastar P-Series PBX System

This topic describes how to customize synchronization rule based on Azure AD groups, so as to synchronize desired Azure AD groups to the PBX extension groups.


The number of Azure AD groups that can be synced depends on the extension groups that PBX system can create (up to 63 extension groups).


You have integrated Yeastar P-Series PBX System with Azure Active Directory.


  1. Log in to PBX web portal, go to Integrations > Collaboration.
  2. Scroll down to the Group Synchronization section, turn on the switch.

  3. In the Synchronize for drop-down list, specify the Azure AD groups that you want to synchronize to PBX.

    Table 1.
    Option Description
    All Groups Synchronize all Azure AD groups to PBX.
    Specific Group Type

    Synchronize the specified type(s) of Azure AD groups to PBX.

    You can select the desired group type(s) in the Type drop-down list.
    • Security Group: All security groups in your organization's directory.
    • Microsoft 365: All Microsoft 365 groups in your organization's directory.
    Specific Group Synchronize specific Azure AD groups to PBX.
    You can directly search and select the desired groups in the Group drop-down list.
    Note: By default, the Group drop-down list displays 200 records of Azure AD groups. If you need the system to display more records, contact Yeastar.
    Note: In future use, if you change the range of Azure AD groups to be synced, you can decide how to deal with the extension groups that are no longer synced from the Azure AD groups via the Auto delete the Extension Groups no longer in sync option.

    • If selected, the extension groups will be deleted during the next synchronization.
    • If unselected, the extension groups will be retained and fully managed by the PBX.
  4. Click Save.



You have created your custom synchronization rule for Azure AD groups.

During a synchronization process, PBX system performs queries within your organization's Azure Active Directory based on the rule, and synchronize the desired Azure AD groups as well as the updated information to PBX. After the synchronization, the followings can be implemented:

  • You can check the synchronization result in the Group Synchronization section.

  • The PBX extension groups associated with Azure AD groups come with a label , and can NOT be deleted.
  • You can NOT manually update the name and group member of the PBX extension groups associated with Azure AD groups on PBX.
    Note: The information can only be modified within the Azure Active Directory and updated to the PBX during a synchronization.