---
title: "Create API Key"
method: POST
path: "/v0/api-keys"
tags: ["ApiKeys"]
---

# Create API Key

`POST /v0/api-keys`

## Request body

- CreateApiKeyRequest
  - `name` string, required — Name of api key.

## Response `200`

- CreateApiKeyResponse
  - `api_key_id` string, required — ID of api key.
  - `api_key` string, required — API key.
  - `prefix` string, required — Prefix of api key.
  - `name` string, required — Name of api key.
  - `pod_id` string, nullable — Pod ID the api key is scoped to.
  - `inbox_id` string, nullable — Inbox ID the api key is scoped to.
  - `created_at` string, date-time, required — Time at which api key was created.

## Other responses

- `400`

## Changes

- **2026-03-18** `f49e3de8fad0` — 1 info
  - added the optional property `inbox_id` to the response with the `200` status
- **2026-03-06** `161e9f5d786c` — 1 info
  - added the optional property `pod_id` to the response with the `200` status

[Change history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/api-keys/post.md)

---

[API](https://skmtc.dev/agentmail-to/apis/api.md) · [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentmail-to/api/revisions/7fdcd6b4651f/schema)