---
title: "Criar chave (self-service)"
method: POST
path: "/keys"
tags: ["Conta"]
---

# Criar chave (self-service)

`POST /keys`

## Request

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

A chave aparece **uma única vez** — guarde no momento da criação, só o hash fica armazenado. A resposta traz também os grupos de acompanhamento, onde mudanças de contrato são anunciadas antes de irem ao ar.

## Request body

- object
  - `name` string, required: Nome do negócio (aparece no painel e nos avisos).
  - `email` string, email: Recomendado: a chave recém-criada é enviada para este e-mail, além de aparecer na resposta.
  - `settlement_address` string: Carteira EVM (Polygon) de liquidação. Opcional; pode ser definida depois.
  - `webhook_url` string, uri: URL HTTPS para os eventos. Opcional.
  - `lead_token` string: Token opaco `ldt_…` devolvido por POST /leads quando a pessoa autorizou contato tecnico (consentimento). Vincula esta chave ao lead. Somente no corpo, nunca na URL. Opcional; ausencia ou token invalido nao impede a criacao.

## Response `201`

Chave criada.

- object
  - `api_key` string: A chave em claro — aparece SÓ nesta resposta (guardamos apenas o hash).
  - `email_sent` boolean: true quando uma cópia da chave foi enviada ao `email` informado. false se não houve e-mail ou o envio falhou.
  - `webhook_secret` string: Presente quando `webhook_url` foi informado.
  - `key` object: Visão pública da chave (prefix, name, flags).
  - `limits` object: Limites vigentes.
  - `monitor_url` string, uri: Monitor ao vivo, só-leitura, do fluxo desta chave.
  - `lead_attribution` object: Resultado do elo de atribuicao quando um lead_token consentido e enviado. Nunca bloqueia a criacao da chave.
    - `requested` boolean, required: true se um lead_token foi enviado no corpo.
    - `linked` boolean, required: true se a chave foi ligada a um lead consentido.
    - `status` 'nao_solicitado' | 'vinculado' | 'token_invalido' | 'indisponivel', required: Estado do vinculo.

## Other responses

- `400`: Campos invalidos (name obrigatorio, webhook_url precisa ser https publica).
- `429`: Limite de criacao de chaves por IP.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)