Criar pessoa
POST/pessoas
Sempre cria: a API nunca procura duplicatas (a unificação é manual, na tela).
Escopo: pessoas:escrever.
Exige Idempotency-Key (mesma chave = mesma resposta, sem efeito duplicado).
Escrita: recusada com a assinatura vencida ou bloqueada.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 429
Sucesso
ERR_VALIDACAO (corpo/consulta inválidos) ou ERR_IDEMPOTENCY_KEY_OBRIGATORIA
ERR_TOKEN_INVALIDO
ERR_ESCOPO_INSUFICIENTE, ERR_APP_NAO_HABILITADO, ERR_ASSINATURA_VENCIDA, ERR_ASSINATURA_BLOQUEADA ou ERR_OPERACAO_RECUSADA (regra do núcleo recusou a escrita)
ERR_NAO_ENCONTRADO: Recurso inexistente ou de outra empresa
ERR_CONTATO_EXISTENTE: WhatsApp já é contato de outra pessoa
ERR_IDEMPOTENCY_KEY_REUTILIZADA: mesma chave com corpo diferente
ERR_LIMITE_REQUISICOES