---
title: REST API endpoints for external groups
shortTitle: External groups
allowTitleToDifferFromFilename: true
intro: >-
  Use the REST API to view the external identity provider groups that are
  available to your organization and manage the connection between external
  groups and teams in your organization.
versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
  ghec: '*'
  ghes: '*'
topics:
  - API
autogenerated: rest
---

## About external groups

{% data reusables.scim.ghes-beta-note %}

To use these endpoints, the authenticated user must be a team maintainer or an owner of the organization associated with the team.

{% ifversion ghec %}

> [!NOTE]
> * These endpoints are only available for organizations that are part of an enterprise using {% data variables.product.prodname_emus %}. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users).
> * If your organization uses team synchronization, you can use the API to manage team synchronization. For more information, see [AUTOTITLE](/rest/teams/team-sync).

{% endif %}

<!-- Content after this section is automatically generated -->