How do I get my API key?

Create and manage your AgentMail API keys.

Steps

Navigate to the API Keys section in the left side of the dashboard

Click Create New API Key

Give it a descriptive name (e.g., “my-support-agent”)

Copy the key immediately and store it securely

Your API key is only shown once when it is created. If you lose it, you will need to create a new one. Never commit API keys to version control or share them publicly.

Using your API key

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

Bash

$ # .env file
$ AGENTMAIL_API_KEY=am_your_key_here

Then initialize the SDK using the environment variable:

TypeScript

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()

Free tier

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

Feature	Limit
Inboxes	3
Emails per month	3,000
Storage	3 GB
API access	Full (REST, WebSockets, webhooks)
SDKs	Python and TypeScript

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

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