Adding organizations to your enterprise

About addition of organizations to your enterprise account

Your enterprise account can own organizations. Members of your enterprise can collaborate across related projects within an organization. For more information, see "About organizations."

You can add new organizations to your enterprise account. If you do not use Enterprise Managed Users, you can add existing organizations on GitHub.com to your enterprise. You cannot add an existing organization from an enterprise with managed users to a different enterprise.

If you currently use GitHub Enterprise Cloud with a single organization, we encourage you to create an enterprise account. For more information, see "Creating an enterprise account."

After you add an existing organization to your enterprise, the organization's resources remain accessible to members at the same URLs, and the following changes will apply.

• The organization's members will become members of the enterprise, and GitHub will bill the enterprise account for the organization's usage. You must ensure that the enterprise account has enough licenses to accommodate any new members. For more information, see "About billing for your enterprise."

• Enterprise owners can manage their role within the organization. For more information, see "Managing your role in an organization owned by your enterprise."

• Any policies applied to the enterprise will apply to the organization. For more information, see "About enterprise policies."

• If SAML SSO is configured for the enterprise account, the enterprise's SAML configuration will apply to the organization. If the organization used SAML SSO, the enterprise account's configuration will replace the organization's configuration. SCIM is not available for enterprise accounts, so SCIM will be disabled for the organization. For more information, see "Configuring SAML single sign-on for your enterprise" and "Switching your SAML configuration from an organization to an enterprise account."

• If SAML SSO was configured for the organization, members' existing personal access token or SSH keys that were authorized to access the organization's resources will be authorized to access the same resources. To access additional organizations owned by the enterprise, members must authorize the personal access token or key. For more information, see "Authorizing a personal access token for use with SAML single sign-on" and "Authorizing an SSH key for use with SAML single sign-on."

• If the organization was connected to GitHub Enterprise Server or GitHub AE using GitHub Connect, adding the organization to an enterprise will not update the connection. GitHub Connect features will no longer function for the organization. To continue using GitHub Connect, you must disable and re-enable the feature. For more information, see the following articles.

  • "Managing GitHub Connect" in the GitHub Enterprise Server documentation
  • "Managing GitHub Connect" in the GitHub AE documentation

• If the organization used billed GitHub Marketplace apps, the organization can continue to use the apps, but must pay the vendor directly. For more information, contact the app's vendor.

• Any coupons will be removed from the organization. To reapply the coupon, contact our sales team.

Creating an organization in your enterprise account

New organizations you create within your enterprise account settings are included in your enterprise account's GitHub Enterprise Cloud subscription.

Enterprise owners who create an organization owned by the enterprise account automatically become organization owners. For more information about organization owners, see "Roles in an organization."

1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

2. In the list of enterprises, click the enterprise you want to view.

3. On the Organizations tab, above the list of organizations, click New organization.

4. Under "Organization name", type a name for your organization.

5. Click Create organization.

6. Under "Invite owners", type the username of a person you'd like to invite to become an organization owner, then click Invite.

7. Click Finish.

Inviting an organization to join your enterprise account

Enterprise owners can invite existing organizations to join their enterprise account. If the organization you want to invite is already owned by another enterprise account, you must be an owner of both enterprise accounts, or the previous enterprise must give up ownership of the organization first. For more information, see "Removing an organization from your enterprise."

1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

2. In the list of enterprises, click the enterprise you want to view.

3. On the Organizations tab, above the list of organizations, click Invite organization.

4. Under "Organization name", start typing the name of the organization you want to invite and select it when it appears in the dropdown list.

5. Click Invite organization.

6. The organization owners will receive an email inviting them to join the enterprise. At least one owner needs to accept the invitation before the process can continue. You can cancel or resend the invitation at any time before an owner approves it.

7. Once an organization owner has approved the invitation, you can view its status in the list of pending invitations.

8. To complete the transfer, click Approve.

Transferring an organization between enterprise accounts

Enterprise owners can transfer existing organizations between enterprise accounts. You must be an enterprise owner of both enterprise accounts.

1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

2. In the list of enterprises, click the enterprise you want to view.

3. Next to the organization you want to transfer, select the dropdown, and then click Transfer organization.

4. Select the Select enterprise dropdown menu, start typing the name of the destination enterprise, and select the enterprise when it appears in the dropdown list.

5. Click Review transfer.

6. To confirm the transfer, click Transfer organization.