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

# Create API Key

`POST /api-keys`

## Request

- Base URL: `https://api.coinvoyage.io/v3`
- URL: `https://api.coinvoyage.io/v3/api-keys`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/docs/api-keys/post.ts> (a function with typed inputs; its response is checked against the schema)

Create another credential for the authenticated entity. The full key and secret are returned only in this response and exact idempotent replays.

## Headers

- `Authorization-Signature` string, required
- `Idempotency-Key` string, required

## Request body

- CreateAPIKeyRequest
  - `label` string

## Response `200`

Idempotent replay

- APIKeyCreated
  - `active` boolean, required
  - `api_key` string, required
  - `api_key_last_four` string, required
  - `api_secret` string, required
  - `created_at` string, date-time, required
  - `id` string, required
  - `is_live` boolean, required
  - `label` string
  - `last_used_at` string, date-time
  - `updated_at` string, date-time, required

## Other responses

- `201`: API key created
- `401`: Unauthorized
- `409`: Idempotency conflict
- `422`: Invalid request
- `500`: Internal Server Error

## Changes

- **2026-08-14** `0ca79f36d480`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/changes/api-keys/post.md)

---

[API](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3.md) - [All operations](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/revisions/3535f46f4c27?raw)