---
title: "Get an API key instantly"
method: POST
path: "/api/v1/keys"
tags: ["keys"]
---

# Get an API key instantly

`POST /api/v1/keys`

## Request

- Base URL: `https://kicksma.sh`
- URL: `https://kicksma.sh/api/v1/keys`
- Auth: none declared

No approval, no email verification. The key is shown once. Say who or what will use it; an assistant may name itself.

## Request body

- object
  - `name` string, required
  - `email` string, email
  - `agent` string: e.g. "claude", "chatgpt", "my-club-bot"

## Response `201`

The key, once

- object
  - `key` string
  - `prefix` string
  - `name` string
  - `limits` object
  - `next` string

## Other responses

- `422`: Invalid request; the message names the field
- `429`: Rate limited; the hint says how to get more room

---

[API](https://skmtc.dev/kicksma/apis/kicksmash-api.md) · [All operations](https://skmtc.dev/kicksma/apis/kicksmash-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kicksma/apis/kicksmash-api/revisions/8ae952aa0f19?raw)