API REST · v1

Conecte o ClinPRO a qualquer ferramenta

Uma API REST simples pra ler e escrever contatos, agendamentos, pipeline e enviar mensagens no WhatsApp da clínica. Ideal pra conectar via Zapier, Make ou n8n — sem escrever código — ou direto do seu sistema.

# Base URL
https://app.gestaoclinpro.com.br/api/v1

Autenticação

Toda requisição precisa da sua chave no cabeçalho Authorization. Gere a chave dentro da sua conta em Configurações → API & Webhooks (só o dono/admin pode). A chave aparece uma única vez — guarde num lugar seguro.

Authorization: Bearer clinpro_live_sua_chave_aqui

Cada chave carrega só os escopos que você marcou. Se faltar escopo, a API responde 403 insufficient_scope.

Escopos / permissões

O que cada chave pode fazer:

contacts:read	Ler contatos / leads
contacts:write	Criar e atualizar contatos
appointments:read	Ler agendamentos
appointments:write	Criar e atualizar agendamentos
pipeline:read	Ler o pipeline (estágios e leads)
messages:send	Enviar mensagem no WhatsApp

Endpoints

GET/api/v1/contactsescopo: contacts:read

Lista os contatos/leads da clínica (paginado por cursor).

curl "https://app.gestaoclinpro.com.br/api/v1/contacts?limit=50" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

POST/api/v1/contactsescopo: contacts:write

Cria um novo contato. Deduplica por telefone.

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/contacts" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Silva",
    "phone": "41999998888",
    "email": "maria@email.com",
    "procedure_interest": "Botox",
    "source": "site"
  }'

GET/api/v1/appointmentsescopo: appointments:read

Lista agendamentos. Filtre por período com from e to (ISO 8601).

curl "https://app.gestaoclinpro.com.br/api/v1/appointments?from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

POST/api/v1/appointmentsescopo: appointments:write

Cria um agendamento.

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/appointments" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_name": "Maria Silva",
    "phone": "41999998888",
    "procedure": "Botox",
    "professional": "Dra. Lorraine",
    "datetime": "2026-07-20T14:30:00-03:00",
    "duration_minutes": 30
  }'

GET/api/v1/pipelineescopo: pipeline:read

Retorna os estágios do pipeline com a contagem de leads em cada um.

curl "https://app.gestaoclinpro.com.br/api/v1/pipeline" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

POST/api/v1/messagesescopo: messages:send

Envia uma mensagem de texto pelo WhatsApp da clínica.

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/messages" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "41999998888",
    "message": "Oi! Sua consulta está confirmada 💜"
  }'

Webhooks

Em vez de ficar consultando a API, deixe o ClinPRO avisar você quando algo acontece. Cadastre uma URL (ex: um webhook do Zapier/Make/n8n) e escolha os eventos. Enviamos um POST assinado com HMAC-SHA256 no cabeçalho x-clinpro-signature.

lead.created· Lead criadolead.stage_changed· Lead mudou de estágioappointment.created· Agendamento criadoappointment.updated· Agendamento atualizadomessage.sent· Mensagem enviada

POST https://sua-url.com/webhook
x-clinpro-event: lead.created
x-clinpro-signature: <hmac-sha256 do corpo>

{
  "event": "lead.created",
  "created_at": "2026-07-11T18:00:00.000Z",
  "data": { "contact": { "id": "...", "name": "Maria Silva", "phone": "41999998888" } }
}

Integra com o quê?

A conexão acontece pela nossa API através do Zapier, Make ou n8n — não temos integração nativa de 1 clique. Qualquer ferramenta com conector nessas plataformas dá pra ligar. Exemplos:

A ponte (sem código)

ZapierMaken8n

Agendas

Google AgendaCalendlyGoogle Meet

CRM & Marketing

HubSpotPipedriveRD Station

Pagamentos

StripeMercado Pago

Google & comunicação

GmailGoogle SheetsNotionTelegramInstagram

Não achou o seu sistema? Se ele tem Zapier/Make/n8n ou aceita webhooks, dá pra conectar. Fale com a gente.

Pronto pra integrar?

Gere sua chave dentro da conta e comece em minutos.

Gerar minha chave de API