diff --git a/machines/working-with-machines.html.markerb b/machines/working-with-machines.html.markerb
index de593d082e..62f93acfc0 100644
--- a/machines/working-with-machines.html.markerb
+++ b/machines/working-with-machines.html.markerb
@@ -91,6 +91,8 @@ Machines must be associated with a Fly App. App names must be unique.
 
 <%= partial "/docs/reference/machines/create_app_req" %>
 
+To segment the app into its own network, you can pass a `network` argument in the JSON body, e.g. `"network": "some-arbitrary-name"`. Any machine started in such an app will not be able to access other apps (within their organization) over the private network.
+
 ### Allocate an IP address for global request routing
 
 If you intend for Machines to be accessible to the internet, you'll need to allocate an IP address to the app. Currently