---
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.
  - `created_at` string, date-time, required — Time at which api key was created.

## Other responses

- `400`

## Changes

- **2026-03-28** `8a5b5e92ae2d` — 4 warning
  - removed the request property `permissions`
  - removed the optional property `inbox_id` from the response with the `200` status
  - removed the optional property `permissions` from the response with the `200` status
  - removed the optional property `pod_id` from the response with the `200` status
- **2026-03-23** `add9c40c7e57` — 70 warning, 70 info
  - removed the request property `permissions/create_api_key`
  - removed the request property `permissions/create_domain`
  - removed the request property `permissions/create_draft`
  - removed the request property `permissions/create_inbox`
  - …136 more
- **2026-03-23** `ec0967a2d85d` — 2 info
  - added the new optional request property `permissions`
  - added the optional property `permissions` to the response with the `200` status
- **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/8a5b5e92ae2d/schema)