Provider guide

Connect GitHub Copilot to Stax.

Live API

Stax pulls Copilot seat assignments, last-activity timestamps, and (from June 2026) usage-based credit consumption from GitHub's REST API. The most useful signal here is which seats have gone idle.

Auth

PAT or App

Org owner only

Setup time

~3 min

5 min for App install

First sync

~5 min

28 days of usage

Top signal

Idle seats

Via last_activity_at

Step 1

Generate a personal access token.

The fastest path is a classic personal access token with the right scope. Sign in to GitHub as an organization owner and visit:

Click Generate new token → Generate new token (classic).
Note: Stax — Copilot billing.
Expiration: pick whatever your security policy allows. Stax will warn you when it's near expiry.
Scope: tick manage_billing:copilot for full billing access, or read:org for read-only seat info (no spend totals).
Click Generate token, copy the value. It starts with ghp_.

Only organization owners can generate this token. Non-owners can tick the scope but the API will return 403 on every Copilot billing call. If you're not the owner, ask them to create the token and share it through a secrets manager.

Prefer a GitHub App? If you'd rather not manage a PAT, Stax can be installed as a GitHub App on your org — that gives you scoped permissions, an audit trail, and zero token rotation. App install lives in /app → Providers → GitHub Copilot. Same data, slightly longer setup.

Step 2

Paste the token into Stax.

In Stax, go to /app → Providers → GitHub Copilot → Connect. Paste the PAT and enter your organization slug (the bit after github.com/ for your org).

Stax validates by calling /orgs/{org}/copilot/billing. If the token doesn't have the right scope or the org doesn't have Copilot enabled, you'll see an inline error before anything is stored.

Step 3

What you'll see after the first sync.

Initial backfill pulls the current seat roster plus 28 days of usage. You'll see:

Seat count, plan name, and billing cycle from /orgs/{org}/copilot/billing.
Per-seat assignee, plan type, and last_activity_at from /orgs/{org}/copilot/billing/seats.
Idle seats: anyone whose last_activity_at is more than 28 days ago surfaces in the dashboard as a candidate to deassign. At $19/seat/mo on Business that's real money on a 20-person team.
Monthly cost = seat count × plan price, until June 1 2026.

Heads-up: GitHub is changing Copilot billing on June 1, 2026. All plans move to usage-based pricing with monthly AI Credit allotments. Stax handles both the pre-June seat-based shape and the post-June credit-based shape — your dashboard will show whichever model your org is on, no action needed from you.

Common errors

403 Resource not accessible

Token created by a non-owner. Even with the right scope ticked, the Copilot endpoints require org-owner role. Have your owner regenerate.

404 Not Found

Org slug typo, or no Copilot subscription. Confirm the slug in the GitHub URL of your org and that the org actually has Copilot Business or Enterprise enabled.

SSO enforcement

Your org enforces SAML SSO on PATs. After generating the PAT, click Configure SSO next to it on the tokens page and authorize it for the org. Without this, every API call fails silently with no row data.

Ready to track this in your AI bill?

Stax is in private beta. Track this provider and your entire AI spend in one dashboard. Join the waitlist to lock in founding-member pricing — $29/mo forever for the first 100 sign-ups.

Join the waitlist →