Better · OAuth Scopes

Better OAuth Scopes

OAuth 2.0 searched

Better publishes 4 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Better API on a user’s behalf.

Tokens are issued from https://prod.bettermg.com/api/idp/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

CompanyMortgageLendingFintechReal EstateHome EquityInsuranceFinancial Services
Scopes: 4 Flows: authorizationCode Method: searched

OAuth endpoints

Authorization URL
https://prod.bettermg.com/api/idp/sso
Token URL
https://prod.bettermg.com/api/idp/token
Flows
authorizationCode

Scopes (4)

ScopeDescriptionFlows
openid OpenID Connect authentication; issue an ID token for the signed-in user. authorizationCode
email Access to the user's email address and email_verified claims. authorizationCode
phone Access to the user's phone_number and phone_number_verified claims. authorizationCode
profile Access to the user's default profile claims (name, etc.). authorizationCode

Source

OAuth Scopes

better-scopes.yml Raw ↑
generated: '2026-07-18'
method: searched
source: well-known/better-openid-configuration.json
docs: https://better.com/.well-known/openid-configuration
note: >-
  OIDC scopes advertised by the consumer sign-in identity provider (AWS Cognito).
  These are standard OpenID Connect scopes, not developer-API permission scopes;
  Better publishes no public developer API.
schemes:
- name: BetterOIDC
  source: well-known/better-openid-configuration.json
  issuer: https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ZQ2HayNPw
  flows:
  - flow: authorizationCode
    authorizationUrl: https://prod.bettermg.com/api/idp/sso
    tokenUrl: https://prod.bettermg.com/api/idp/token
scopes:
- scope: openid
  description: OpenID Connect authentication; issue an ID token for the signed-in user.
  flows: [authorizationCode]
  sources: [well-known/better-openid-configuration.json]
- scope: email
  description: Access to the user's email address and email_verified claims.
  flows: [authorizationCode]
  sources: [well-known/better-openid-configuration.json]
- scope: phone
  description: Access to the user's phone_number and phone_number_verified claims.
  flows: [authorizationCode]
  sources: [well-known/better-openid-configuration.json]
- scope: profile
  description: Access to the user's default profile claims (name, etc.).
  flows: [authorizationCode]
  sources: [well-known/better-openid-configuration.json]