Connecting an Azure subscription

About Azure subscriptions

If you are an organization owner, you can connect an Azure Subscription ID to your organization account to enable and pay for any GitHub metered services. For example, GitHub Codespaces usage, and for GitHub Actions or GitHub Packages usage, beyond the amounts included with your account, or Copilot for Business. For more information, see "About billing for GitHub Actions," "About billing for GitHub Packages," and "Managing billing for GitHub Copilot."

You cannot add an Azure subscription to an enterprise account that is part of a GitHub Enterprise Cloud free trial.

After you connect an Azure subscription, you can also manage your spending limits.

• "Managing your spending limit for GitHub Packages"
• "Managing your spending limit for GitHub Actions"
• "Managing the spending limit for GitHub Codespaces"

Connecting your Azure subscription to your organization account

To connect your Azure subscription, you must have owner permissions to the subscription.

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

   

2. Next to the organization, click Settings.

3. In the "Access" section of the sidebar, click Billing and plans.

4. Under "Billing Management", to the right of "Metered billing via Azure", 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.

7. Under "Select a subscription", select the Azure Subscription ID that you want to connect to your enterprise.

   Note: GitHub's Subscription Permission Validation requests read-only access to display the list of available subscriptions. 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 Microsoft identity platform and OAuth 2.0 authorization code flow in Microsoft Docs.

8. Click Connect.

Disconnecting your Azure subscription from your organization account

After you disconnect your Azure subscription from your organization account, your usage can no longer exceed the amounts included with your plan.

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

   

2. Next to the organization, click Settings.

3. In the "Access" section of the sidebar, click Billing and plans.

4. Under "Billing Management", then under "Metered billing via Azure", to the right of the subscription ID you want to disconnect, click .

5. Review the prompt, then click Remove.