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

# Create an API key

`POST /config/api-keys`

## Request

- Base URL: `https://orbitus.netcorecloud.com`
- URL: `https://orbitus.netcorecloud.com/config/api-keys`
- Auth: HTTP bearer

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/orbit-router.md) - [All operations](https://skmtc.dev/netcorecloud/apis/orbit-router/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/orbit-router/revisions/680f0a8ab1a3?raw)