---
title: "Create a new API key"
method: POST
path: "/v1/api-keys"
tags: ["ApiKeys"]
---

# Create a new API key

`POST /v1/api-keys`

## Request

- Base URL: `https://api.usemektup.com`
- URL: `https://api.usemektup.com/v1/api-keys`
- Auth: HTTP bearer

The full key is returned exactly once, in this response - save it immediately, it cannot be retrieved again later.

## Response `201`

Created

- CreateApiKeyResult
  - `id` string, uuid
  - `key_prefix` string
  - `created_at` string, date-time
  - `revoked_at` string, date-time, nullable
  - `key` string: The full plaintext key - shown once, not recoverable later

---

[API](https://skmtc.dev/usemektup/apis/mektup-api.md) · [All operations](https://skmtc.dev/usemektup/apis/mektup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usemektup/apis/mektup-api/revisions/b64e649247e7?raw)