From 07191e66b3df0b1d9c9043124433557ed99a36c4 Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Tue, 7 Apr 2026 03:37:36 +0000
Subject: [PATCH] Add 'Create an API key' section to agent onboarding page

---
 fern/pages/integrations/agent-onboarding.mdx | 28 ++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/fern/pages/integrations/agent-onboarding.mdx b/fern/pages/integrations/agent-onboarding.mdx
index 99794db..4706ab1 100644
--- a/fern/pages/integrations/agent-onboarding.mdx
+++ b/fern/pages/integrations/agent-onboarding.mdx
@@ -72,6 +72,34 @@ Alternatively, a human can create an account at [console.agentmail.to](https://c
   AgentMail's free tier includes 3 inboxes and 3,000 emails/month. Your agent can start building immediately.
 </Info>
 
+## Create an API key
+
+Once you have an account, create additional API keys via the API or the [Console](https://console.agentmail.to):
+
+<CodeBlocks>
+
+```python title="Python"
+key = client.api_keys.create(name="my-agent-key")
+print(key.api_key)  # starts with am_, shown only once
+```
+
+```typescript title="TypeScript"
+const key = await client.apiKeys.create({ name: "my-agent-key" });
+console.log(key.apiKey);  // starts with am_, shown only once
+```
+
+```bash title="CLI"
+agentmail api-keys create --name "my-agent-key"
+```
+
+</CodeBlocks>
+
+<Warning>
+  API keys are only shown once at creation. Store them securely.
+</Warning>
+
+You can also create keys scoped to a specific [pod](/core-concepts/pods) or [inbox](/core-concepts/inboxes). See the [API reference](/api-reference/api-keys/create-api-key) for details.
+
 ## AgentMail MCP Server
 
 MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. The AgentMail MCP server gives your AI agent tools to create inboxes, send emails, manage threads, and more.