Skip to content
Navigation

Sign in with an OAuth token

Exchange a provider token for Truememory tokens.

For the client-side flow: your frontend completes sign-in with the provider SDK and posts the resulting token here, which is verified with Google Identity Platform before Truememory tokens are issued. Send either id_token or access_token.

POST
https://truememory-auth.mvstg.com/auth/oauth/token
View as Markdown

Request bodyJSONrequired

  • providergoogleorapplerequired

    OAuth provider name.

  • id_tokenoptional

    ID token from the OAuth provider (preferred over access_token).

    One of the following:

    • string
    • null
  • access_tokenoptional

    Access token from the OAuth provider (used when id_token unavailable).

    One of the following:

    • string
    • null
  • nonceoptional

    Raw nonce for Apple Sign-In tokens generated with a hashed nonce (e.g. expo-apple-authentication).

    One of the following:

    • string
    • null
  • tenant_idoptional

    Google Identity Platform tenant ID for tenant-scoped sign-in.

    One of the following:

    • string
    • null
  • metadataoptional

    Initial metadata to store on first-time OAuth signup. Max 50 keys, 16 KB.

    One of the following:

    • object
    • null

Returns

200

Successful Response

JSON
  • id_tokenstringrequired
  • refresh_tokenstringrequired
  • expires_instringrequired
  • useroptional

    One of the following:

    • AuthUser
      • idstringrequired
        format: uuid
      • gip_uidstringrequired
      • tenant_idoptional

        One of the following:

        • string
        • null
      • emailoptional

        One of the following:

        • string
        • null
      • email_verifiedoptionalboolean
        default: false
      • usernameoptional

        One of the following:

        • string
        • null
      • display_nameoptional

        One of the following:

        • string
        • null
      • photo_urloptional

        One of the following:

        • string
        • null
      • phone_numberoptional

        One of the following:

        • string
        • null
      • disabledoptionalboolean
        default: false
      • roleoptionalstring
        default: "user"
      • metadataoptionalobject
      • raw_app_meta_dataoptionalobject
      • custom_claimsoptionalobject
      • last_sign_in_atoptional

        One of the following:

        • string
        • null
      • created_atoptional

        One of the following:

        • string
        • null
      • updated_atoptional

        One of the following:

        • string
        • null
      • deleted_atoptional

        One of the following:

        • string
        • null
      • deletion_completed_atoptional

        One of the following:

        • string
        • null
    • null

422

Validation Error
JSON
  • detailoptionalarray ofobject
    • locarray ofrequired

      One of the following:

      • string
      • integer
    • msgstringrequired
    • typestringrequired
    • inputoptionalunknown
    • ctxoptionalobject

Type to search…

↑↓ navigate↵ selectEsc close