Custom OAuth Scopes
WorkOS July 15, 2025
Configure custom OAuth scopes in the WorkOS Dashboard. Access and refresh tokens from the OAuth provider pass through to your app, with optional additional scopes via the provider_scopes query parameter.
Overview
Developers can now configure custom OAuth scopes in the WorkOS Dashboard. When configured, the access token and refresh token from the OAuth provider will be passed through to your application, allowing you to access user accounts with the permissions granted.
Dynamic scopes
Developers can also specify additional scopes dynamically using the new provider_scopes query parameter. That makes it easier to request just the permissions you need per request without changing dashboard settings.
Questions or want to work together? Get in touch.