Skip to main content

Creating an enterprise account as a Microsoft CSP partner

Learn how to set up an enterprise account for your customer as a Microsoft Cloud Solution Provider partner.

Who can use this feature?

Microsoft Cloud Solution Provider (CSP) partners setting up GitHub Enterprise.
GitHub partners should see Creating and paying for a client's enterprise account.

Prerequisites

Before you start, make sure you know:

  • GitHub username of the client who will become the owner of the enterprise you create
  • GitHub username for the CSP partner that must be assigned to the customer’s enterprise account to manage metered billing and access support
  • Enterprise name your client would like to use
  • Email address for receipts
  • Number of seats your client needs in the enterprise
  • Enterprise account type required by your client, see Choosing an enterprise type for GitHub Enterprise Cloud

Step 1: Create the enterprise account in the Azure portal

As a Microsoft CSP partner, you can get started with GitHub Enterprise from the Microsoft Azure portal.

  1. Sign in to the Microsoft Azure portal.
  2. In the search bar, type "GitHub" and select GitHub to go the landing page.
  3. Select Get started with GitHub Enterprise.
  4. Choose an enterprise type. To help you decide which choice is best for the enterprise, see Choosing an enterprise type for GitHub Enterprise Cloud.
  5. Complete the form with your client's information.
  6. Click Create your enterprise.

Step 2: Purchase GitHub Enterprise

At any time during the trial, you can purchase GitHub Enterprise for your client by linking it to their Azure subscription. If the account is later transferred to the customer, ensure the Azure subscription is fully managed by them.

  1. In the top-right corner of GitHub, click your profile picture.

  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.

  3. At the top of the page, in the blue banner, click Activate Enterprise.

  4. Click Add Azure subscription.

  5. To sign in to your Microsoft account, follow the prompts.

  6. Review the "Permissions requested" prompt. If you agree with the terms, click Accept.

    If you don't see a "Permissions requested" prompt, and instead see a message indicating that you need admin approval, see Troubleshooting Azure subscription connection problems.

  7. Under "Select a subscription", select the Azure Subscription ID that you want to connect to your organization. To select an Azure subscription, you must have owner permissions to the subscription. If the default tenant does not have the right permissions, you may need to specify a different tenant ID. For more information, see Azure subscription payments and Microsoft identity platform and OAuth 2.0 authorization code flow in Microsoft Docs.

    1. Select By clicking "Connect", you are confirming that you want to be billed for metered services via the selected Azure subscription.
    2. Click Connect.
  8. Click Activate Enterprise.

Step 3: Invite your client as an enterprise owner

Invite your client to become an enterprise owner. See Inviting people to manage your enterprise.

Step 4: Change your role to billing manager

Optionally, you can change your role to billing manager to manage the billing for the enterprise account, without having full administrative access.

  1. In the top-right corner of GitHub, click your profile picture.

  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.

  3. At the top of the page, click People.

  4. Under " People", click Administrators.

  5. Confirm that your client is listed as an enterprise owner.

  6. To the right of your username, select the dropdown menu, then click Change role.

    Screenshot of a user in the administrators list. A dropdown menu, labeled with a kebab icon, is highlighted with an orange outline.

  7. Select Billing manager, then click Change role.

Contacting support

As a Microsoft CSP partner, you can use the GitHub Support for Microsoft CSP landing page to speak to GitHub Support. For more information about creating a support ticket, see Creating a support ticket.