---
title: "Request a free sandbox API key (sends a verification email)"
method: POST
path: "/v1/keys"
---

# Request a free sandbox API key (sends a verification email)

`POST /v1/keys`

## Request

- Base URL: `https://agentmandate-api.com`
- URL: `https://agentmandate-api.com/v1/keys`
- Auth: none required

Starts self-serve key issuance. A one-time claim token is emailed to the address you supply; POST it to /v1/keys/claim to receive the key. No key is returned here, and the response is the same whether or not that address already has an account — so this endpoint cannot be used to find out who has one. The email is verified because your account, your usage and your invoice are all keyed to it: issuing on an unverified address would let anyone mint a working key on your account and spend your allowance. Keep using the same address and a paid plan bought with it raises the keys you already hold rather than issuing new ones. Distributed integrations may identify their discovery surface with the optional source object or x-integration-source header; invalid source values are ignored and never block key issuance.

## Request body

- object
  - `email` string, email, required: Where the claim token is sent. This becomes your account.
  - `name` string: Optional label for the key, e.g. "staging". Shown in GET /v1/keys.
  - `source` object: Optional discovery metadata supplied by a README, SDK, Postman collection or MCP client.
    - `source` string
    - `medium` string
    - `campaign` string
    - `content` string

## Response `202`

Success

- object
  - `status` 'verification_sent'
  - `email` string, email
  - `expiresAt` string, date-time: After this, request a new one.
  - `next` string: The endpoint that turns the emailed token into a key.
  - `message` string
  - `requestId` string

## Other responses

- `400`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `500`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.

---

[API](https://skmtc.dev/agentmandate-api/apis/agent-mandate.md) · [All operations](https://skmtc.dev/agentmandate-api/apis/agent-mandate/llms.txt) · [OpenAPI document](https://skmtc.dev/agentmandate-api/apis/agent-mandate/revisions/463fe122c4d8?raw)