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

# Create a new API key

`POST /api/v1/keys`

## Request

- Base URL: `https://verifly.email`
- URL: `https://verifly.email/api/v1/keys`
- Auth: HTTP bearer

Create a new API key. The full key is returned ONCE in the 'key' field; store it immediately.

## Request body

- object
  - `name` string: Optional friendly name.

## Response `200`

Key created (full key shown once).

- KeyCreateResult
  - `success` boolean, required
  - `key` string, required: Full vf_ key, shown only once.
  - `message` string
  - `details` object
    - `id` string
    - `name` string, nullable
    - `prefix` string
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `429`: Too many requests. Includes Retry-After (seconds) and the X-RateLimit-* headers.

---

[API](https://skmtc.dev/verifly/apis/verifly-email-verification-api.md) · [All operations](https://skmtc.dev/verifly/apis/verifly-email-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifly/apis/verifly-email-verification-api/revisions/9b2787c04363?raw)