diff --git a/doc/api/http2.md b/doc/api/http2.md
index 1d0befd6f7d0eb..e7f6c3293423a5 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -984,6 +984,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