---
title: "Create a named test or live key with letter scopes; secret shown once."
method: POST
path: "/v1/account/api-keys"
---

# Create a named test or live key with letter scopes; secret shown once.

`POST /v1/account/api-keys`

## Request

- Base URL: `https://paperagent.dev`
- URL: `https://paperagent.dev/v1/account/api-keys`
- Auth: API key in cookie `__Host-pa_session`

## Headers

- `X-CSRF-Token` string, required

## Request body

- object
  - `name` string, required
  - `livemode` boolean, required
  - `scopes` string[], required

## Response `201`

Success

- object
  - `id` string, required
  - `name` string, required
  - `secret` string, required
  - `prefix` string, required
  - `livemode` boolean, required
  - `scopes` string[], required

## Other responses

- `default`: Browser session, CSRF, validation, or account policy error.

---

[API](https://skmtc.dev/paperagent/apis/paperagent-rest-api.md) · [All operations](https://skmtc.dev/paperagent/apis/paperagent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperagent/apis/paperagent-rest-api/revisions/388148938051?raw)