diff --git a/doc/api.md b/doc/api.md
new file mode 100644
index 0000000..36530eb
--- /dev/null
+++ b/doc/api.md
@@ -0,0 +1,11 @@
+# nntpchan jsonrpc api
+
+To enable set the following in `srnd.ini` section `frontend`
+
+    [frontend]
+    ...
+    json-api = 1
+    json-api-username = something-really-long
+    json-api-password = somethine-different-but-also-very-long
+
+see the example tool at `contrib/tools/api/post.js`