diff --git a/content/docs/agents/settings.mdx b/content/docs/agents/settings.mdx
index efbc86d..328ce7e 100644
--- a/content/docs/agents/settings.mdx
+++ b/content/docs/agents/settings.mdx
@@ -42,6 +42,15 @@ Use **Environment** for variables that tools on the hosted machine can read.
 
 Some integration variables are reserved. `SUPERWALL_API_KEY` comes from the organization selector. `GH_TOKEN`, `GITHUB_TOKEN`, and `SLACK_BOT_TOKEN` come from the GitHub and Slack connection flows.
 
+<Note>
+  **Need a Superwall API key?** In Superwall Agents, select your organization in
+  the chat header. Agents provides a managed organization API key to new turns,
+  so you usually do not add `SUPERWALL_API_KEY` here. For an external agent,
+  custom tool, or local script, create an organization API key in
+  [Settings > API Keys](/dashboard/dashboard-settings/overview-settings-access-controls#api-key-access).
+  Do not use the public `pk_` SDK key for server or API access.
+</Note>
+
 <Warning>
   Do not paste secret values into chat. Store them in Environment so tools can
   use them without adding the secret to conversation history.