diff --git a/homeassistant/components/services.yaml b/homeassistant/components/services.yaml
index 522939a213a..519d3b98704 100644
--- a/homeassistant/components/services.yaml
+++ b/homeassistant/components/services.yaml
@@ -509,3 +509,38 @@ homeassistant:
       entity_id:
         description: The entity_id of the device to turn off.
         example: light.living_room
+
+xiaomi_aqara:
+  play_ringtone:
+    description: Play a specific ringtone. The version of the gateway firmware must be 1.4.1_145 at least.
+    fields:
+      gw_mac:
+        description: MAC address of the Xiaomi Aqara Gateway.
+        example: 34ce00880088
+      ringtone_id:
+        description: One of the allowed ringtone ids.
+        example: 8
+      ringtone_vol:
+        description: The volume in percent.
+        example: 30
+  stop_ringtone:
+    description: Stops a playing ringtone immediately.
+    fields:
+      gw_mac:
+        description: MAC address of the Xiaomi Aqara Gateway.
+        example: 34ce00880088
+  add_device:
+    description: Enables the join permission of the Xiaomi Aqara Gateway for 30 seconds. A new device can be added afterwards by pressing the pairing button once.
+    fields:
+      gw_mac:
+        description: MAC address of the Xiaomi Aqara Gateway.
+        example: 34ce00880088
+  remove_device:
+    description: Removes a specific device. The removal is required if a device shall be paired with another gateway.
+    fields:
+      gw_mac:
+        description: MAC address of the Xiaomi Aqara Gateway.
+        example: 34ce00880088
+      device_id:
+        description: Hardware address of the device to remove.
+        example: 158d0000000000