diff --git a/changelog.d/9434.doc b/changelog.d/9434.doc
new file mode 100644
index 000000000..0500848a1
--- /dev/null
+++ b/changelog.d/9434.doc
@@ -0,0 +1 @@
+Properly document that Synapse v1.27.0 requires updating the sAML2 callback URL (similar to OpenID Connect). See [UPGRADE.rst](UPGRADE.rst) for more information.