diff --git a/docs/admin/auth.md b/docs/admin/auth.md
index fb278cf09b058..4c846573cd8ac 100644
--- a/docs/admin/auth.md
+++ b/docs/admin/auth.md
@@ -31,6 +31,9 @@ GitHub will ask you for the following Coder parameters:
 Note the Client ID and Client Secret generated by GitHub. You will use these
 values in the next step.
 
+Coder will need permission to access user email addresses. Find the "Account
+Permissions" settings for your app and select "read-only" for "Email addresses".
+
 ### Step 2: Configure Coder with the OAuth credentials
 
 Navigate to your Coder host and run the following command to start up the Coder