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}`);

Scoped API keys

In addition to organization-level keys, you can create keys scoped to a single pod or inbox. Scoped keys restrict access so that the key can only operate on resources within that pod or inbox.

• Pod-scoped keys: Create via POST /pods/{pod_id}/api-keys or client.pods.api_keys.create()
• Inbox-scoped keys: Create via POST /inboxes/{inbox_id}/api-keys or client.inboxes.api_keys.create()

See the Multi-Tenancy guide for details.

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.