How do I get my API key?

You need an API key to authenticate requests to the AgentMail API. API keys start with am_ and are created in the AgentMail Console.

Steps

1. Go to the AgentMail Console
2. Sign up or log in
3. Navigate to the API Keys section in the left side of the dashboard
4. Click Create New API Key
5. Give it a descriptive name (e.g., “my-support-agent”)
6. Copy the key immediately and store it securely

Using your API key

Store your API key in an environment variable to keep it out of your source code:

$
# .env file
$
AGENTMAIL_API_KEY=am_your_key_here

Then initialize the SDK using the environment variable:

1
import { AgentMailClient } from "agentmail";
2
import "dotenv/config";
3
4
const client = new AgentMailClient({
5
  apiKey: process.env.AGENTMAIL_API_KEY,
6
});
7
8
// Test the connection by creating an inbox
9
const inbox = await client.inboxes.create();
10
console.log(`Connected! Created inbox: ${inbox.inboxId}`);

Free tier

No credit card required to get started. The free tier includes:

To create more inboxes or send higher volumes, see the pricing page.