Skip to main content

POST Criar Paciente

Criar Paciente. Cria um paciente atrelado a Account com os dados fornecidos.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão create_patients.


Endpoint​

POST https://api-dev.imagemais.com.br/api/patients

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
namestring✅até 200 caracteres; não vazioNome completo do paciente
dateBirthstring❌data ISO 8601Data de nascimento do paciente no formato YYYY-MM-DD
genderobject❌—gênero do paciente (M para Masculino, F para Feminino, etc.)
gender.namestring❌F, Mgênero do paciente (M para Masculino, F para Feminino, etc.)
rgstring❌—Número do RG do paciente
cpfstring❌11–11 caracteresNúmero do CPF do paciente (11 dígitos) - opcional
addressobject❌—Informações de Endereço
address.streetstring❌—Nome da rua do endereço do paciente
address.numberstring❌—Número da casa ou apartamento do endereço do paciente
address.districtstring❌—Nome do bairro do endereço do paciente
address.citystring❌—Nome da cidade do paciente
address.statestring❌—Nome do estado do paciente
address.cepstring❌—CEP do endereço do paciente
address.complementstring❌—Complemento do endereço do paciente
contactobject❌—Informações de Contato
contact.phonestring❌—Telefone
contact.secondary_phonestring❌—Telefone secundário
contact.emailstring❌e-mailE-mail

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/patients' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "João da Silva",
"dateBirth": "2000-01-01",
"gender": "M",
"rg": "123456789",
"cpf": "12345678900",
"address": {},
"contact": {}
}'

Respostas​

201 Sucesso​

{
"id": 61,
"name": "Nome Exemplo",
"gender": null,
"dateBirth": null,
"rg": null,
"cpf": null,
"address": null,
"contact": null,
"createdAt": "2026-09-30T18:48:39.732Z",
"updatedAt": "2026-09-30T18:48:39.732Z",
"deletedAt": null
}

400 Requisição inválida​

Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:

{
"message": [
"name should not be empty",
"name must be shorter than or equal to 200 characters",
"name must be a string"
],
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

409 Conflito​

{
"message": "Já existe um paciente com esse CPF",
"error": "Conflict",
"statusCode": 409
}