diff --git a/changelogs/client_server/newsfragments/2382.clarification b/changelogs/client_server/newsfragments/2382.clarification
new file mode 100644
index 00000000..6461d0b8
--- /dev/null
+++ b/changelogs/client_server/newsfragments/2382.clarification
@@ -0,0 +1 @@
+Disambiguate placeholder descriptions in OlmPayload example.
\ No newline at end of file
diff --git a/data/api/client-server/definitions/olm_payload.yaml b/data/api/client-server/definitions/olm_payload.yaml
index 8bac91e0..fa3e7cc9 100644
--- a/data/api/client-server/definitions/olm_payload.yaml
+++ b/data/api/client-server/definitions/olm_payload.yaml
@@ -65,15 +65,15 @@ example: {
   "sender": "<sender_user_id>",
   "recipient": "<recipient_user_id>",
   "recipient_keys": {
-    "ed25519": "<our_ed25519_key>"
+    "ed25519": "<recipient_ed25519_key>"
   },
   "keys": {
     "ed25519": "<sender_ed25519_key>"
   },
   "sender_device_keys": {
     "algorithms": ["<supported>", "<algorithms>"],
-    "user_id": "<user_id>",
-    "device_id": "<device_id>",
+    "user_id": "<sender_user_id>",
+    "device_id": "<sender_device_id>",
     "keys": {
       "ed25519:<device_id>": "<sender_ed25519_key>",
       "curve25519:<device_id>": "<sender_curve25519_key>"