This integration enables your Webex users to create groups in Microsoft 365 when they create teams in Webex. When you've done the integration, this is how it works for your users.

You'll need admin access to your Microsoft tenant, the MS365 groups feature, and your users in Azure AD. Optionally you can sync users to Webex from your on-premises Active Directory, but first you must sync them to AD from Azure AD.

You'll also need admin access to your Webex organization, to check that users are synced, and to enable content management.

Microsoft 365 requirements

  • A Global admin account on your Microsoft tenant.

  • Microsoft 365 groups feature.

  • Users in Azure Active Directory.

Webex requirements

  • A Webex organization and full administrator account.

  • Webex messaging entitlement for users (enabled free by default).

    You can set up automatic license assignment to make sure that the users get this entitlement when you synchronize them from your directory.

  • Users synchronized with Webex in one of these ways:

    • Synchronize users from Azure Active Directory to your Webex organization


      You automatically get Webex externalId populated with Azure objectId.

    • Synchronize users from Active Directory on-premises

      With this option, you must first synchronize the objectId from Azure AD to your on-prem AD, then map the property to the externalId in Webex.

      Read the Deployment guide for Directory Connector to learn how to map AD user attributes to Webex user attributes, then synchronize the groups.

    If the user's externalId is successfully synchronized, you can see the External ID property and its value on the user's profile in Control Hub. Otherwise, the External ID property is not shown on the profile.
  • Webex user accounts must be Active (users have signed in to Webex).

  • Configure Enterprise Content Management settings for your organization, and enable it for all your users. Read These are the settings that you need:

    • Select Microsoft content management.

    • Toggle Enable linked folders.

    • Enter your Azure Active Directory (AD) Tenant Name.

    • If required, select the Microsoft Global instance.

      You won't see the option to choose the Azure instance unless you are also a tenant in a special instance, like Microsoft Germany. This feature is only available for Webex organizations that are tenants in the Microsoft Global instance.

Before you begin

The essential prerequisite is that the Webex user's externalId property must match the Azure user's objectId property.

There are two ways to create this link on your Webex users:


Sign in to Control Hub at and go to the Hybrid page.


Find the Groups integration card.


Click View prerequisites.

The list is active, and shows green ticks for the complete Content Management prerequisites. If the content management settings are incomplete, Control Hub guides you to the right place to get them done.


Click Next.


Read the note about permissions, and then click Authorize.


Enter your Microsoft admin credentials when prompted.


Read the list of permissions and click Accept.

You see a success message.


Click Go to settings.

Another way to get to the settings page is Hybrid > Groups integration > Edit settings.


Slide the switch to Enable Microsoft 365 Groups Integration.

What to do next

To edit these settings, go to the Hybrid page and find the Groups integration card.