diff --git a/pages/docs/platform/webhooks.mdx b/pages/docs/platform/webhooks.mdx
index ce1aad98e..d1e976862 100644
--- a/pages/docs/platform/webhooks.mdx
+++ b/pages/docs/platform/webhooks.mdx
@@ -85,7 +85,7 @@ Transforms are defined as simple JavaScript functions that accept three argument
     The raw JSON payload from the POST request body
   </Property>
   <Property name="headers" type="object" attribute>
-    A map of HTTP headers sent along with the request as key-value pairs.
+    A map of HTTP headers sent along with the request as key-value pairs. Header names are case-insensitive and are canonicalized by making the first character and any characters following a hyphen uppercase and the rest lowercase. For more details, [check out](https://pkg.go.dev/net/http#CanonicalHeaderKey) the underlying implementation reference.
   </Property>
   <Property name="queryParams" type="object" attribute>
     A map of parsed query string parameters sent to the webhook URL. Values are all arrays to support multiple params for a single key.
@@ -112,6 +112,12 @@ function transform(evt, headers = {}, queryParams = {}) {
 
 ### Example transforms
 
+<Callout variant="info">
+  💡 Header names are case-insensitive and are canonicalized by making the first character and any characters following a hyphen uppercase and the rest lowercase.
+
+  Remember to check your transforms for header usage and make sure to use the correct case.
+</Callout>
+
 <details>
   <summary>**Github** - Using headers</summary>
 
@@ -237,4 +243,4 @@ inngest.createFunction(
 
 <Callout>
   💡 **Tip**: To test functions locally, copy an event from a webhook from the Inngest dashboard and use it with the Inngest dev server's `Send test` button.
-</Callout>
\ No newline at end of file
+</Callout>