Issue an API key

POST/v1/api_keys

Key scope: write · Success: 201

A new key in the same mode, shown once; SET keeps only its SHA-256. Its scopes are never broader than the calling key's. At most 10 active keys. Event api_key.created.

Headers

Idempotency-Key string: Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

scopes ["read"] | ["read", "write"]: Default: the calling key's scopes.
label string: 1–40 letters, digits, spaces or . _ : -.

Errors

400 scopes_invalid
400 label_invalid
403 scope_exceeds_caller
409 too_many_keys
403 operator_cannot_issue
401 api_key_required
401 api_key_invalid
401 api_key_wrong_mode
403 scope_missing
429 rate_limited

All codes: Errors.

Request

curl -X POST "https://wallet.simpleeasytransactions.com/v1/api_keys" \
  -H "Authorization: Bearer $SET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scopes": ["read"], "label": "Reconciliation job" }'

Body

{ "scopes": ["read"], "label": "Reconciliation job" }

Response 201

{ "id": "key_…", "object": "api_key", "key": "set_live_…", "prefix": "set_live_a1b", "scopes": ["read"], "label": "Reconciliation job", "livemode": true, "createdAt": "2026-11-08T15:04:05.000Z", "note": "Shown once. SET keeps only its SHA-256." }