social / pragma.account / AccountService / createAccountV1 /
createAccountV1 #
suspend fun createAccountV1(session: ServiceSession, request: AccountRpc.CreateAccountV1Request): AccountRpc.CreateAccountV1Response
Creates a Pragma Account, authenticates a user against an IdentityProvider, and returns SessionTokens used for gateway authentication.
Unlike AccountService.authenticateOrCreateV2, if a Pragma account is already associated with the IdentityProvider the call will throw AccountRpc.AccountAlreadyExistsApplicationError.
Warning: This endpoint bypasses the login queue and is intended for web clients only. Usage of this endpoint in a game client is strongly discouraged.
References
Plugins
- IdentityProvider.canAuthenticate
- IdentityProvider.validate - PragmaResultErrors returned are just thrown as PragmaExceptions
- AccountPlugin.onAccountLogin - Called when the user successfully authenticates, including when the user is created
- AccountPlugin.onAccountCreate - Called before an account is created for the first time
- AccountPlugin.onAccountCreated - Called after an account is created for the first time
PragmaApplicationErrors
- AccountRpc.UnauthorizedApplicationError when trying to authenticate with an unexpected session type
- AccountRpc.UnauthorizedApplicationError when failing to create authentication tokens
- pragma.IdProviderNotFoundApplicationError when authenticating with an unknown or unconfigured IdentityProvider.
- AccountRpc.RanOutOfDiscriminatorsApplicationError when display name has been reused too many times
- AccountRpc.IdProviderAuthenticationDisabledApplicationError when authenticating with a disabled IdentityProvider.
- AccountRpc.AccountAlreadyExistsApplicationError when Pragma account is already associated with the IdentityProvider
PragmaResultErrors
- PragmaError.Database_Error when failing to create a social identity