Implement the Brightspace Valence OAuth 2.0 Authorization Code grant with refresh tokens for a user-facing application

domain: education · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. In Manage Extensibility, register an OAuth 2.0 app choosing the Authorization grant workflow, supply a valid Redirect URI, list the scopes you need, and optionally enable "Prompt for user consent" and "Enable refresh tokens".
  2. Direct the user's browser to the authorization endpoint https://auth.brightspace.com/oauth2/auth with your Client ID, redirect_uri, and requested scope to start the Authorization Code Grant flow per RFC 6749.
  3. After the user authenticates and consents, Brightspace redirects to your Redirect URI with an authorization code; exchange it at https://auth.brightspace.com/core/connect/token using your Client ID and Client Secret for an access token (and, if enabled, a refresh token).
  4. Send the access token as `Authorization: Bearer <token>` on API calls; when it expires, use the Refresh workflow to exchange the single-use refresh token for a new access/refresh token pair without re-prompting the user.
  5. To revoke access, have the user remove the app from My Settings > Account Settings > Manage Applications, or delete and re-register the app in Manage Extensibility to rotate compromised credentials.

Known gotchas

Related routes

Authenticate to the D2L Brightspace Valence API using the OAuth 2.0 Client Credentials grant for a server-to-server integration
education · 6 steps · unrated
Authenticate to the Brightspace (D2L) Valence API using OAuth 2.0 instead of the deprecated ID-Key signing scheme.
docs.valence.desire2learn.com · 5 steps · unrated
Enroll a user in a Brightspace course offering via the Valence enrollment API
docs.valence.desire2learn.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans