---
title: "Create an API key"
method: POST
path: "/config/api-keys"
tags: ["Configuration"]
---

# Create an API key

`POST /config/api-keys`

Returns the full plaintext API key **once**. The backend stores only the SHA-256 hash.
Store your key securely immediately.

## Request body

- object
  - `name` string, required
  - `type` 'http' | 'smtp', required

## Response `201`

API key created (includes full plaintext key).

- ApiKeyCreated
  - `id` integer
  - `name` string
  - `key` string — Full plaintext API key (shown once).
  - `type` 'http' | 'smtp'
  - `created_at` string, date-time

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)