diff --git a/CHANGELOG.md b/CHANGELOG.md
index cce7a97e1d11d..d550b6f6b1ead 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@
 
 - server: add support for `_inc` on `real`, `double`, `numeric` and `money` (fix #3573)
 - server: support special characters in JSON path query argument with bracket `[]` notation, e.g `obj['Hello World!']` (#3890) (#4482)
+- docs: add API docs for using environment variables as webhook urls in event triggers
 
 ## `v1.2.0-beta.4`
 
diff --git a/docs/graphql/manual/api-reference/schema-metadata-api/event-triggers.rst b/docs/graphql/manual/api-reference/schema-metadata-api/event-triggers.rst
index a13cebc1f9d18..170665dbb71c6 100644
--- a/docs/graphql/manual/api-reference/schema-metadata-api/event-triggers.rst
+++ b/docs/graphql/manual/api-reference/schema-metadata-api/event-triggers.rst
@@ -82,9 +82,13 @@ Args syntax
      - :ref:`QualifiedTable <QualifiedTable>`
      - Object with table name and schema
    * - webhook
-     - true
+     - false
      - String
-     - Full url of webhook
+     - Full url of webhook (*)
+   * - webhook_from_env
+     - false
+     - String
+     - Environment variable name of webhook (must exist at boot time) (*)
    * - insert
      - false
      - OperationSpec_
@@ -106,6 +110,8 @@ Args syntax
      - Boolean
      - If set to true, the event trigger is replaced with the new definition
 
+(*) Either ``webhook`` or ``webhook_from_env`` are required.
+
 .. _delete_event_trigger:
 
 delete_event_trigger