diff --git a/doc/api/http2.md b/doc/api/http2.md
index 3ff984a3e25e6a..382ef11a6edf0a 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -983,6 +983,15 @@ argument identifying the frame type, and an integer argument identifying the
 error code. The `Http2Stream` instance will be destroyed immediately after the
 `'frameError'` event is emitted.
 
+#### Event: `'ready'`
+<!-- YAML
+added: v8.4.0
+-->
+
+The `'ready'` event is emitted when the `Http2Stream` has been opened, has
+been assigned an `id`, and can be used. The listener does not expect any
+arguments.
+
 #### Event: `'timeout'`
 <!-- YAML
 added: v8.4.0