diff --git a/changelogs/client_server/newsfragments/1637.clarification b/changelogs/client_server/newsfragments/1637.clarification
new file mode 100644
index 00000000..5833554d
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1637.clarification
@@ -0,0 +1 @@
+Clarify the available error codes, and when to prefer the HTTP status code over the ``errcode``.