POST

/v1/patients

Cadastrar paciente

Permissão:patients:write

Autenticação

Envie o token de acesso do usuário no cabeçalho Authorization e, se ele tiver mais de uma clínica, o X-Clinic-Id. Integrações servidor a servidor usam o token de serviço com X-Clinic-Id e X-Agent-Key. Como autenticar

1Authorization: Bearer <TOKEN>2X-Clinic-Id: <clinic_id>

Parâmetros

Cabeçalhos

Cabeçalhos
Parâmetro	Tipo	Obrigatório	Descrição
`X-Clinic-Id`	string	Não	Clínica ativa. Obrigatório só para quem tem acesso a mais de uma clínica (ou token de serviço). Validado contra o vínculo do usuário. · Padrão (regex): `^[A-Za-z0-9._-]{1,64}$`

X-Clinic-IdstringOpcional
Clínica ativa. Obrigatório só para quem tem acesso a mais de uma clínica (ou token de serviço). Validado contra o vínculo do usuário. · Padrão (regex): ^[A-Za-z0-9._-]{1,64}$

Corpo da requisição

application/json · obrigatório

Campos do corpo da requisição
Parâmetro	Tipo	Obrigatório	Descrição
`name`	string	Sim	Entre 2 e 128 caracteres
`birthDate`	string \| null	Não	Formato `AAAA-MM-DD`
`sex`	string \| null	Não	Valores: `Feminino`, `Masculino`, `Outro`, `Não informado`
`cpf`	string \| null	Não	Write-only: nunca é devolvido completo. · Padrão (regex): `^\d{3}\.?\d{3}\.?\d{3}-?\d{2}$`
`phone`	string \| null	Não	Até 32 caracteres
`email`	string (e-mail) \| null	Não	Até 160 caracteres
`city`	string \| null	Não	Até 80 caracteres
`address`	string \| null	Não	Até 255 caracteres
`status`	string	Não	Valores: `ativo`, `inativo`
`tags`	string[]	Não	Até 20 itens · Cada item: até 40 caracteres
`serviceKey`	string \| null	Não	Até 64 caracteres
`plan`	string \| null	Não	Valores: `Particular`, `Convênio`
`origin`	string \| null	Não	Até 64 caracteres
`professionalKey`	string \| null	Não	Até 64 caracteres
`leadId`	string \| null	Não	Entre 1 e 64 caracteres · Padrão (regex): `^[A-Za-z0-9._-]+$`
`lgpdConsent`	boolean	Não	true registra o consentimento LGPD agora.

namestringObrigatório
Entre 2 e 128 caracteres
birthDatestring | nullOpcional
Formato AAAA-MM-DD
sexstring | nullOpcional
Valores: Feminino, Masculino, Outro, Não informado
cpfstring | nullOpcional
Write-only: nunca é devolvido completo. · Padrão (regex): ^\d{3}\.?\d{3}\.?\d{3}-?\d{2}$
phonestring | nullOpcional
Até 32 caracteres
emailstring (e-mail) | nullOpcional
Até 160 caracteres
citystring | nullOpcional
Até 80 caracteres
addressstring | nullOpcional
Até 255 caracteres
statusstringOpcional
Valores: ativo, inativo
tagsstring[]Opcional
Até 20 itens · Cada item: até 40 caracteres
serviceKeystring | nullOpcional
Até 64 caracteres
planstring | nullOpcional
Valores: Particular, Convênio
originstring | nullOpcional
Até 64 caracteres
professionalKeystring | nullOpcional
Até 64 caracteres
leadIdstring | nullOpcional
Entre 1 e 64 caracteres · Padrão (regex): ^[A-Za-z0-9._-]+$
lgpdConsentbooleanOpcional
true registra o consentimento LGPD agora.

Exemplo de requisição

Gerado do contrato. Troque os marcadores entre < > pelos seus valores.

1const res = await fetch("https://myclinc.leadpoint.com.br/v1/patients", {2  method: "POST",3  headers: {4    Authorization: "Bearer <TOKEN>",5    "X-Clinic-Id": "<clinic_id>",6    "Content-Type": "application/json",7  },8  body: JSON.stringify({9    "name": "<name>",10    "birthDate": "2026-09-18",11    "sex": "Feminino",12    "cpf": "<cpf>",13    "phone": "<phone>",14    "email": "contato@exemplo.com",15    "city": "<city>",16    "address": "<address>"17  }),18})1920if (!res.ok) {21  const { error } = await res.json()22  throw new Error(`${error.code}: ${error.message} (${error.requestId})`)23}24const { data } = await res.json()

Resposta

201Created — Sucesso.

JSON

1{2  "data": {3    "id": "<id>",4    "name": "<name>",5    "age": 1,6    "sex": "Feminino",7    "birthDate": "2026-09-18",8    "cpf": "<cpf>",9    "phone": "<phone>",10    "email": "<email>",11    "city": "<city>",12    "address": "<address>",13    "status": "ativo",14    "isNew": true,15    "tags": [16      "<tag>"17    ],18    "service": {19      "key": "<key>",20      "name": "<name>"21    },22    "plan": "Particular",23    "origin": "Lead (Instagram)",24    "professional": {25      "key": "<key>",26      "name": "<name>"27    },28    "lastVisitAt": "2026-09-18T14:00:00.000Z",29    "lastVisitDaysAgo": 1,30    "nextAppointment": {31      "id": "<id>",32      "date": "2026-09-18",33      "time": "<time>",34      "professional": "<professional>",35      "type": "<type>"36    },37    "leadId": "<leadId>",38    "lgpdConsentAt": "2026-09-18T14:00:00.000Z",39    "createdAt": "2026-09-18T14:00:00.000Z",40    "updatedAt": "2026-09-18T14:00:00.000Z"41  }42}

Exemplo gerado do esquema da resposta; valores entre < > são ilustrativos.

Códigos de erro

Corpo no formato padrão { error: { code, message, requestId } }. Veja todos os códigos.

400

Bad Request — Requisição malformada (JSON inválido, cursor inválido ou clínica ativa não informada).

401

Unauthorized — Token ausente, inválido ou expirado.

403

Forbidden — Autenticado, mas sem permissão (perfil ou clínica).

422

Unprocessable Entity — Dados semanticamente inválidos (erros por campo em details).

429

Too Many Requests — Limite de requisições excedido (veja Retry-After).

500

Internal Server Error — Erro interno (sem detalhes expostos).

503

Service Unavailable — Banco de dados indisponível ou não configurado.

Limites

Limite padrão: 120 requisições a cada 60 segundos por token. Sobre limites

Testar no Swagger