GitHub Copilot

Software.com automatically tracks AI coding metrics from the GitHub Copilot usage APIs, giving you insight into adoption, activity, and the impact of AI tools on your team’s productivity.

Connection methods

Connect your GitHub account to enable Copilot metrics. How you connect depends on where you do your Git hosting:

• If you use GitHub for source control, installing our GitHub App  is sufficient. The App uses OAuth and does not expire, and it also enables productivity metrics in Software.com.
• If you use another Git provider (e.g., Azure DevOps, Bitbucket, or GitLab) and manage Copilot licenses through GitHub Enterprise, connect using a GitHub Enterprise Personal Access Token (PAT) so we can access Copilot usage via the Enterprise APIs.

Important notes:

• Billing and seat utilization – This data is only available at the organization level in GitHub. You will not see seat utilization metrics if you do not have a GitHub Organization.
• Team data – If you have a GitHub Organization, we sync your GitHub Teams to help with analysis. We do not currently sync teams from the Enterprise level.

Connecting via GitHub App

If you use GitHub, we recommend installing our GitHub App  when you create your Software.com organization. The connection is handled via OAuth and does not expire.

Connecting via Personal Access Token (PAT)

Use this method when your team uses a different Git provider (Azure DevOps, Bitbucket, GitLab) and you manage Copilot through GitHub Enterprise.

1. Enable Copilot usage metrics in your enterprise or organization

Copilot usage metrics are disabled by default. An enterprise admin must enable them:

Enterprise

Example: github.com/enterprises/{your_enterprise_slug}/ai-controls/copilot

1. On github.com , open the AI Controls tab.
2. Select Copilot in the left sidebar.
3. In the Metrics section, enable Copilot metrics API and Copilot usage metrics.

Organization

Example: github.com/organizations/{your_org_slug}/settings/copilot/policies

1. On github.com , go to Settings > Copilot > Policies.
2. Enable Copilot metrics API and Copilot usage metrics.

This turns on the Copilot APIs for your enterprise so administrators and billing managers can access usage and adoption data.

2. Create a PAT with the required scopes

The user who connects must be an enterprise owner or billing manager. Create a PAT (Classic) with:

• read:enterprise – Read-only access to enterprise-level data (viewing/listing only; does not include profile data of members or organizations).
• manage_billing:copilot – Ability to view and edit Copilot Business seat assignments; this is the most restrictive scope that allows access to Copilot metadata.

See GitHub OAuth scopes  for more detail.

3. Connect in Software.com

1. In Software.com, go to Settings > Connected Apps.

2. Find GitHub Copilot Enterprise and click Connect.
3. Paste your PAT. Set an expiration (e.g., 1 year) and add a reminder to refresh it before it expires.
4. Enter your Enterprise Slug (the unique name in your GitHub URL: github.com/enterprises/YOUR-SLUG). It must match an enterprise you can access.

5. Click Save to complete the connection.

Data collected

We use read-only access to the following GitHub Copilot APIs:

Organization APIs

• GET /orgs/{org}/copilot/metrics
• GET /orgs/{org}/team/{team_slug}/copilot/metrics
• GET /orgs/{org}/copilot/billing
• GET /orgs/{org}/copilot/billing/seats
• GET /orgs/{org}/copilot/metrics/reports/users-1-day

Enterprise APIs

• GET /enterprises/{enterprise}/copilot/metrics
• GET /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest
• GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day

For full parameter and response details, see the Copilot metrics API .