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.

• If two-factor authentication (2FA) is required by the enterprise, organization members who do not use 2FA will be removed from the organization.

• 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.

• If your organization was sponsoring any accounts, the sponsorships will be canceled.

• 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. Optionally, 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. If you're not, you can ask an owner of the enterprise account that currently owns the organization to transfer the organization to your enterprise account instead. For more information, see "Transferring an organization between enterprise accounts."

When you invite an organization to join your enterprise account, at least one owner needs to accept the invitation. Then, you must give a final approval for the transfer.

After you invite the organization, and before an owner approves the invitation, you can cancel or resend the invitation at any time.

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. The organization owners will receive an email inviting them to join the enterprise.

6. After an organization owner has approved the invitation, navigate back to the the Organizations tab of the enterprise settings.

7. Under "Organizations", click X pending.

8. To complete the transfer, next to the organization name, 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 menu, then click Transfer organization.

   

4. Select the Select enterprise dropdown menu, start typing the name of the destination enterprise, and click the enterprise you want to transfer the organization to.

5. Click Review transfer.

6. To confirm the transfer, click Transfer organization.