diff --git a/api/client-server/pusher.yaml b/api/client-server/pusher.yaml
index 34050d3f..d232baf9 100644
--- a/api/client-server/pusher.yaml
+++ b/api/client-server/pusher.yaml
@@ -222,7 +222,9 @@ paths:
                     type: string
                     description: |-
                       Required if ``kind`` is ``http``. The URL to use to send
-                      notifications to.
+                      notifications to. MUST be an HTTPS URL with a path of 
+                      ``/_matrix/push/v1/notify``.
+                    example: "https://push-gateway.location.here/_matrix/push/v1/notify"
                   format:
                     type: string
                     description: |-