Email and password

createUserWithEmailAndPassword

The createUserWithEmailAndPassword method creates a new user account with an email and password. The email and password parameters are required. On success it returns a UserCredential that contains the created user's information.

final cred = await auth.createUserWithEmailAndPassword(
  email: 'a@b.com',
  password: '123456',
);
print(cred.user.email);

FirebaseAuthException

If createUserWithEmailAndPassword fails, a FirebaseAuthException is thrown. The error code is given in the code field; for example 'email-already-in-use' or 'weak-password'. Therefore you should wrap the call in try/catch.

try {
  await auth.createUserWithEmailAndPassword(
    email: email, password: password);
} on FirebaseAuthException catch (e) {
  print(e.code);
}

Exercise Register a user

Get the auth instance, create a new user with createUserWithEmailAndPassword using email 'a@b.com' and password '123456'. Print the email from the returned UserCredential.

Show example solution

class User {
  final String email;
  User(this.email);
}

class UserCredential {
  final User user;
  UserCredential(this.user);
}

class FirebaseAuth {
  static final FirebaseAuth instance = FirebaseAuth._();
  FirebaseAuth._();
  User? _user;
  User? get currentUser => _user;

  Future<UserCredential> createUserWithEmailAndPassword({
    required String email,
    required String password,
  }) async {
    _user = User(email);
    return UserCredential(_user!);
  }
}

void main() async {
  final auth = FirebaseAuth.instance;
  final cred = await auth.createUserWithEmailAndPassword(
    email: 'a@b.com',
    password: '123456',
  );
  print(cred.user.email);
}

Test yourself

What does createUserWithEmailAndPassword return on success?
- Only an error code
- A FirebaseAuth instance
- UserCredential
- An empty Future
Show answer

UserCredential — On successful registration a UserCredential is returned; its user field gives access to the created user.

Call the registration method

final cred = await auth.____(
  email: 'a@b.com',
  password: '123456',
);

Show answer

final cred = await auth.createUserWithEmailAndPassword(
  email: 'a@b.com',
  password: '123456',
);

Registration parts

createUserWithEmailAndPassword

Creates a new user
UserCredential

Operation result
email:

Email address
password:

Password

Next lesson: signInWithEmailAndPassword

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies