diff --git a/docs/external_api_rest.md b/docs/external_api_rest.md
index 7e1640d2..9b871528 100644
--- a/docs/external_api_rest.md
+++ b/docs/external_api_rest.md
@@ -349,6 +349,8 @@ $ curl -X GET -H "Authorization: Bearer ABCDEFGH" \
 
 Updates or creates a state. You can create any state that you want, it does not have to be backed by an entity in Home Assistant. 
 
+> :info: NOTE: This endpoint sets the representation of a device within Home Asistant and will not communicate with the actual device. To communicate with the device, use the [POST /api/services/<domain>/<service>](#post-apiservicesltdomainltservice) endpoint.
+
 Expects a JSON object that has at least a state attribute:
 
 ```json