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
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
name | string | ✅ | até 200 caracteres; não vazio | Nome completo do paciente |
dateBirth | string | ❌ | data ISO 8601 | Data de nascimento do paciente no formato YYYY-MM-DD |
gender | object | ❌ | — | gênero do paciente (M para Masculino, F para Feminino, etc.) |
gender.name | string | ❌ | F, M | gênero do paciente (M para Masculino, F para Feminino, etc.) |
rg | string | ❌ | — | Número do RG do paciente |
cpf | string | ❌ | 11–11 caracteres | Número do CPF do paciente (11 dígitos) - opcional |
address | object | ❌ | — | Informações de Endereço |
address.street | string | ❌ | — | Nome da rua do endereço do paciente |
address.number | string | ❌ | — | Número da casa ou apartamento do endereço do paciente |
address.district | string | ❌ | — | Nome do bairro do endereço do paciente |
address.city | string | ❌ | — | Nome da cidade do paciente |
address.state | string | ❌ | — | Nome do estado do paciente |
address.cep | string | ❌ | — | CEP do endereço do paciente |
address.complement | string | ❌ | — | Complemento do endereço do paciente |
contact | object | ❌ | — | Informações de Contato |
contact.phone | string | ❌ | — | Telefone |
contact.secondary_phone | string | ❌ | — | Telefone secundário |
contact.email | string | ❌ |
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
}