# AgentMail Create API Key

> AgentMail Create API Key is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-10).

Creates a new API key scoped to a specific AgentMail pod, enabling programmatic access to that pod's resources.

## Facts

- Endpoint: POST https://mpp.api.agentmail.to/v0/pods/:pod_id/api-keys?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-api-keys-57de1e47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pnUGPYQEh_Su8Xo2yvDXw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-api-keys-57de1e47 -d '<json body>'
```

Example prompt: Generate a new API key for my AgentMail pod with ID 'pod_abc123' so I can start sending and receiving emails programmatically.

## When to prefer this

Use this endpoint when you need to programmatically provision API credentials for an AgentMail pod — for example, when onboarding a new AI agent that needs its own authenticated access to email inboxes, or when rotating existing credentials. Prefer this over listing keys when you need to create net-new access rather than audit existing ones.

## Known failure modes

- Pod not found — returns 404 if the pod_id does not exist or is inaccessible
- Unauthorized — returns 401 if the caller lacks permission to manage keys for the pod
- Validation error — returns 400 if pod_id is missing or malformed
- Rate limit exceeded — returns 429 if too many keys are created in a short window

## How this service works

Create API key

## Output

Returns a newly created API key object including the key value, key ID, and creation timestamp, scoped to the specified pod. The key can then be used to authenticate requests to that pod's inboxes, threads, and other resources.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "ascending": {
   "type": "boolean",
   "title": "Ascending",
   "description": "Sort in ascending temporal order."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-api-keys-57de1e47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)