diff --git a/doc/schemas/index.json b/doc/schemas/index.json
index d9ae8eb4b9..19626b3ad1 100644
--- a/doc/schemas/index.json
+++ b/doc/schemas/index.json
@@ -1,6 +1,6 @@
 {
     "title": "Protocol Reference",
-    "description": "This reference is generated from JSON Schemas used in the testing and development of Valent.\n\nThis document should not be interpreted as a formal specification of the KDE Connect protocol.",
+    "description": "This reference is generated from JSON Schemas used in the testing and development of Valent. For any other use, please see the upstream version of the [KDE Connect protocol](https://invent.kde.org/network/kdeconnect-meta/blob/master/protocol.md) instead.",
     "sections": [
         {
             "title": "Core Protocol",
diff --git a/doc/schemas/kdeconnect.telephony.json b/doc/schemas/kdeconnect.telephony.json
index d81a997630..dd90d8f957 100644
--- a/doc/schemas/kdeconnect.telephony.json
+++ b/doc/schemas/kdeconnect.telephony.json
@@ -56,7 +56,7 @@
                     ]
                 },
                 "contactName": {
-                    "type": "string",
+                    "type": ["string", "null"],
                     "description": "The contact name associated with the event."
                 },
                 "messageBody": {
@@ -64,7 +64,7 @@
                     "description": "The message text associated with the event."
                 },
                 "phoneNumber": {
-                    "type": "string",
+                    "type": ["string", "null"],
                     "description": "The phone number associated with the event."
                 },
                 "phoneThumbnail": {