diff --git a/examples/README.md b/examples/README.md
index 305e8a78c..41a2f1ff8 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -856,6 +856,36 @@ DocumentResult response =
 System.out.println(response);
 ```
 
+### [Example request as a stream](snippets/postDocument/example_request_as_a_stream.java)
+
+[embedmd]:# (snippets/postDocument/example_request_as_a_stream.java)
+```java
+// section: code imports
+import java.io.FileInputStream;
+
+import com.ibm.cloud.cloudant.v1.Cloudant;
+import com.ibm.cloud.cloudant.v1.model.Document;
+import com.ibm.cloud.cloudant.v1.model.DocumentResult;
+import com.ibm.cloud.cloudant.v1.model.PostDocumentOptions;
+// section: code
+Cloudant service = Cloudant.newInstance();
+
+try (FileInputStream productsDocumentStream = new FileInputStream("products_doc.json")) {
+    PostDocumentOptions documentOptions =
+        new PostDocumentOptions.Builder()
+            .db("products")
+            .contentType("application/json")
+            .body(productsDocumentStream)
+            .build();
+
+    DocumentResult response =
+        service.postDocument(documentOptions).execute()
+            .getResult();
+
+    System.out.println(response);
+}
+```
+
 ## putDatabase
 
 _PUT `/{db}`_
diff --git a/examples/snippets/postDocument/example_request_as_a_stream.java b/examples/snippets/postDocument/example_request_as_a_stream.java
new file mode 100644
index 000000000..5f5eb636e
--- /dev/null
+++ b/examples/snippets/postDocument/example_request_as_a_stream.java
@@ -0,0 +1,24 @@
+// section: code imports
+import java.io.FileInputStream;
+
+import com.ibm.cloud.cloudant.v1.Cloudant;
+import com.ibm.cloud.cloudant.v1.model.Document;
+import com.ibm.cloud.cloudant.v1.model.DocumentResult;
+import com.ibm.cloud.cloudant.v1.model.PostDocumentOptions;
+// section: code
+Cloudant service = Cloudant.newInstance();
+
+try (FileInputStream productsDocumentStream = new FileInputStream("products_doc.json")) {
+    PostDocumentOptions documentOptions =
+        new PostDocumentOptions.Builder()
+            .db("products")
+            .contentType("application/json")
+            .body(productsDocumentStream)
+            .build();
+
+    DocumentResult response =
+        service.postDocument(documentOptions).execute()
+            .getResult();
+
+    System.out.println(response);
+}