diff --git a/docs/reference.md b/docs/reference.md
index 0cbbf586..c64b5d6a 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -21,4 +21,16 @@ serial.writeNumber(0);
 control.inBackground(() => {
     
 });
+```
+
+## Advanced
+
+```namespaces
+bluetooth.onBluetoothConnected(() => {
+    
+});
+```
+
+```package
+microbit-bluetooth
 ```
\ No newline at end of file
diff --git a/docs/reference/bluetooth.md b/docs/reference/bluetooth.md
new file mode 100644
index 00000000..ef65f1a1
--- /dev/null
+++ b/docs/reference/bluetooth.md
@@ -0,0 +1,20 @@
+# Bluetooth
+
+```cards
+bluetooth.onBluetoothConnected(() => {
+    
+});
+bluetooth.onBluetoothDisconnected(() => {
+    
+});
+bluetooth.startAccelerometerService();
+bluetooth.startButtonService();
+bluetooth.startIOPinService();
+bluetooth.startLEDService();
+bluetooth.startMagnetometerService();
+bluetooth.startTemperatureService();
+```
+
+```package
+microbit-bluetooth
+```
\ No newline at end of file