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
- 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.
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
+
+ 💡 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.
+
+
**Github** - Using headers
@@ -237,4 +243,4 @@ inngest.createFunction(
💡 **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.
-
\ No newline at end of file
+