Skip to main content

POST Criar Agendamento

Cria um ou mais agendamentos para um paciente.

Autenticação necessária

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

Um agendamento por procedimento

Cada item em procedures[] gera um agendamento separado. Os horários são distribuídos automaticamente a partir do startTime, em blocos do intervalMinutes configurado na agenda do médico para aquele dia da semana (scheduleDays) — o endTime enviado não é usado no cálculo.

Paciente novo ou existente

Com patient.id, o paciente existente é atualizado com os dados enviados; sem patient.id, um novo paciente é criado.


Endpoint​

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

Corpo da Requisição​

Campos principais​

CampoTipoObrigatórioDescrição
doctorIdnumber✅ID do médico
datestring✅Data do agendamento no formato YYYY-MM-DD
startTimestring✅Horário de início no formato HH:mm
endTimestring✅Horário de término no formato HH:mm (obrigatório na validação, mas recalculado pelo servidor)
notesstring❌Observações do agendamento
prioritystring❌Prioridade do paciente: Gestante, Idoso, PcD ou Criança
isFitboolean❌Indica se é um encaixe. Com true, a verificação de conflito de horário é ignorada

patient​

CampoTipoObrigatórioDescrição
patient.namestring✅Nome do paciente (máx. 200 caracteres). Obrigatório também com patient.id — sem ele a atualização do paciente falha com 500 "Erro ao atualizar paciente"
patient.idnumber❌ID do paciente (quando já cadastrado)
patient.dateBirthstring❌Data de nascimento no formato YYYY-MM-DD (hoje ou anterior)
patient.cpfstring❌CPF do paciente (exatamente 11 dígitos, somente números)
patient.rgstring❌RG do paciente
patient.gender.namestring❌Gênero. Exemplo: M, F
patient.address.streetstring❌Logradouro
patient.address.numberstring❌Número
patient.address.districtstring❌Bairro
patient.address.citystring❌Cidade
patient.address.statestring❌Estado
patient.address.cepstring❌CEP
patient.address.complementstring❌Complemento
patient.contact.phonestring❌Telefone principal
patient.contact.secondary_phonestring❌Telefone secundário
patient.contact.emailstring❌E-mail

procedures[]​

CampoTipoObrigatórioDescrição
procedures[].idnumber✅ID do procedimento
procedures[].discountIdnumber❌ID do desconto a aplicar no procedimento

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/appointments' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patient": {
"name": "João Silva",
"dateBirth": "1990-01-01",
"cpf": "12345678900",
"gender": {
"name": "M"
}
},
"procedures": [
{
"id": 1
},
{
"id": 2,
"discountId": 1
}
],
"doctorId": 1,
"date": "2026-05-17",
"startTime": "09:00",
"endTime": "09:15",
"notes": "Observações sobre o agendamento",
"priority": "PcD",
"isFit": false
}'

Respostas​

201 Criado​

Retorna um array com um agendamento criado por procedimento.

[
{
"id": 5281,
"date": "2026-05-17T00:00:00.000Z",
"startTime": "09:00",
"endTime": "09:10",
"notes": "Observações sobre o agendamento",
"accountId": 1,
"isFit": false,
"createdAt": "2026-05-16T14:17:37.694Z",
"createdByUserId": 11,
"updatedAt": "2026-05-16T14:17:37.694Z",
"deletedAt": null,
"doctor": {
"id": 2,
"name": "Dr. Victor Rocha"
},
"patient": {
"id": 17535,
"name": "Joao Silva",
"dateBirth": "1990-01-01T00:00:00.000Z",
"cpf": "27238001055",
"contact": null
},
"status": {
"id": 1,
"name": "Agendado",
"color": "#ffc107"
},
"createdBy": {
"id": 11,
"name": "Ana Ferreira Souza"
},
"appointmentProcedures": {
"price": "252",
"discountsAppointmentProcedures": null,
"procedure": {
"id": 1,
"name": "17 BETA ESTRADIOL E2 - PRIMEIRA AMOSTRA",
"price": "252"
}
}
},
{
"id": 5282,
"date": "2026-05-17T00:00:00.000Z",
"startTime": "09:10",
"endTime": "09:20",
"notes": "Observações sobre o agendamento",
"accountId": 1,
"isFit": false,
"createdAt": "2026-05-16T14:17:37.694Z",
"createdByUserId": 11,
"updatedAt": "2026-05-16T14:17:37.694Z",
"deletedAt": null,
"doctor": {
"id": 2,
"name": "Dr. Victor Rocha"
},
"patient": {
"id": 17535,
"name": "Joao Silva",
"dateBirth": "1990-01-01T00:00:00.000Z",
"cpf": "27238001055",
"contact": null
},
"status": {
"id": 1,
"name": "Agendado",
"color": "#ffc107"
},
"createdBy": {
"id": 11,
"name": "Ana Ferreira Souza"
},
"appointmentProcedures": {
"price": "252",
"discountsAppointmentProcedures": {
"discountId": 6,
"value": "75.6",
"discount": {
"id": 6,
"name": "Desconto de parente",
"fixed": null,
"percentage": 30,
"expirationDate": null
}
},
"procedure": {
"id": 2,
"name": "17 BETA ESTRADIOL E2 - SEGUNDA AMOSTRA",
"price": "252"
}
}
}
]

400 Bad Request​

Retornado quando o médico não tem agenda configurada para o dia da semana da data informada.

{
"message": "Médico não atende neste dia",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando nenhum dos procedimentos informados existe na conta.

{
"message": "Procedimentos não encontrados",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando o período cai em um bloqueio da agenda do médico (o motivo do bloqueio aparece entre parênteses, quando houver).

{
"message": "Agenda do médico bloqueada neste período (Férias)",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando a data é anterior a hoje.

{
"message": [
"A data deve ser hoje ou uma data futura"
],
"error": "Bad Request",
"statusCode": 400
}

404 Não Encontrado​

Retornado quando o médico informado não existe.

{
"message": "Médico não encontrado",
"error": "Not Found",
"statusCode": 404
}

Retornado quando o desconto informado não existe.

{
"message": "Desconto não encontrado",
"error": "Not Found",
"statusCode": 404
}

409 Conflito​

Retornado quando já existe um paciente cadastrado com o CPF informado.

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

Retornado quando o horário informado já está ocupado por outro agendamento.

{
"message": "Horários 09:00 já estão ocupados por outros agendamentos",
"error": "Conflict",
"statusCode": 409
}