diff --git a/stream/examples.json b/stream/examples.json
new file mode 100644
index 0000000..9f504b3
--- /dev/null
+++ b/stream/examples.json
@@ -0,0 +1,12 @@
+
+{
+    "publish": [{
+        "title": "Publish a message",
+        "description": "Publish a message to a topic on the stream",
+        "request": {
+            "topic": "events",
+            "message": {"id": "1", "type": "signup", "user": "john"}
+        },
+        "response": {}
+    }]
+}