diff --git a/docs/history.md b/docs/history.md
index 42e99c987a..bb78744f5f 100644
--- a/docs/history.md
+++ b/docs/history.md
@@ -80,7 +80,7 @@ For making this great framework even better!
by [henriquealbert](https://github.com/henriquealbert).
#### Breaking Changes
- N/A
+* `Accounts.createUserVerifyingEmail` is now async
#### Internal API changes
* Internal methods from `OAuth` that are now async:
diff --git a/guide/source/2.9-migration.md b/guide/source/2.9-migration.md
index 6da327420a..0ea83e0730 100644
--- a/guide/source/2.9-migration.md
+++ b/guide/source/2.9-migration.md
@@ -70,6 +70,43 @@ We now have async version of methods that you already use. They are:
- [Meteor.userAsync()](https://github.com/meteor/meteor/pull/12274)
- [CssTools.minifyCssAsync()](https://github.com/meteor/meteor/pull/12105)
+
Breaking async
+
+`Accounts.createUserVerifyingEmail` is now completely async:
+
+- [Accounts.createUserVerifyingEmail](https://github.com/meteor/meteor/issues/12398)
+
+To upgrade change from
+```js
+Meteor.methods({
+ createUserAccount (user) {
+ /**
+ * This seems to be the issue.
+ * Using the other method `createUser` works as expected.
+ */
+ Accounts.createUserVerifyingEmail({
+ username: user.username,
+ email: user.email,
+ password: user.password,
+ });
+ }
+});
+```
+
+to
+
+```js
+Meteor.methods({
+ async createUserAccount (user) {
+ await Accounts.createUserVerifyingEmail({
+ username: user.username,
+ email: user.email,
+ password: user.password,
+ });
+ }
+});
+```
+
Accounts-base without service-configuration
Now `accounts-base` is [no longer tied up](https://github.com/meteor/meteor/pull/12202) with `service-configuration`. So, if you don't use third-party login on your project, you don't need to add the package `service-configuration` anymore.