---
title: "Create an inbox key"
method: POST
path: "/v1/inboxes/{inboxId}/api-keys"
tags: ["Inboxes"]
---

# Create an inbox key

`POST /v1/inboxes/{inboxId}/api-keys`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/inboxes/{inboxId}/api-keys`
- Auth: HTTP bearer

An `sk_inbox_…` key that opens only this inbox: read, send, reply, drafts, labels. It can't change the inbox's status, security mode or lists, release held mail, manage keys, or reach any other API. Shown once.

## Path parameters

- `inboxId` string, required

## Request body

- object
  - `name` string

## Response `201`

Created — store `key` now.

- object
  - `keyId` string, required
  - `inboxId` string, required
  - `name` string, nullable
  - `prefix` string, required
  - `lastUsedAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `key` string

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

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