POST/v2/auth/signup

Criar conta (signup)

Registra um novo usuário com e-mail e senha. A senha é armazenada com Argon2id e nunca aparece em logs. A resposta já inclui o par de tokens: access token JWT de curta duração (1 hora) e refresh token opaco de 30 dias.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
email	string	sim	E-mail único do usuário. Um e-mail de verificação é enviado automaticamente.
password	string	sim	Mínimo de 10 caracteres. Senhas vazadas em breaches conhecidos são rejeitadas.
name	string	sim	Nome completo exibido no perfil.
metadata	object	não	Dados livres do seu app, até 4 KB, retornados no payload do JWT.

Request body

{
  "email": "ana@exemplo.com.br",
  "password": "correta-bateria-cavalo-grampo",
  "name": "Ana Ribeiro",
  "metadata": {
    "plano": "pro"
  }
}

Response · 200 OK

{
  "user": {
    "id": "usr_7h2j9s",
    "email": "ana@exemplo.com.br",
    "name": "Ana Ribeiro",
    "email_verificado": false,
    "criado_em": "2026-07-13T10:00:00Z"
  },
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "rt_9f3k2m8x7q1w5e4h",
  "expires_in": 3600
}

curl -X POST "https://api.chaveauth.dev/v2/auth/signup" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $CHAVEAUTH_API_KEY" \
  -d '{
    "email": "ana@exemplo.com.br",
    "password": "correta-bateria-cavalo-grampo",
    "name": "Ana Ribeiro"
  }'

Testar agora

Sandbox

POST/v2/auth/signup

name