diff --git a/hub/api.rst b/hub/api.rst
index 4b884c48ca..52e9719639 100644
--- a/hub/api.rst
+++ b/hub/api.rst
@@ -150,6 +150,11 @@ With curl:
 Get a list of all the datasets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. warning::
+
+   Do not use the dataset API to write data in production. To push data into Sesam, use either an
+   :ref:`HTTP endpoint source <http_endpoint_source>` or the :ref:`JSON Push Protocol <json_push_protocol>`.
+
 With curl:
 
 ::
diff --git a/hub/json-push.rst b/hub/json-push.rst
index dd4e2f9593..68ab0e3abb 100644
--- a/hub/json-push.rst
+++ b/hub/json-push.rst
@@ -1,3 +1,5 @@
+.. _json_push_protocol:
+
 ==================
 JSON Push Protocol
 ==================