Introdução

Bem-vindo à documentação da API Pública V1 do Gens CRM.

Esta API permite que a clínica integre o CRM com sistemas próprios — n8n, ERP, site, planilha interna — sem abrir os dados de outra clínica. Cada chave pertence a uma única clínica. O consumidor nunca escolhe a clínica na requisição: o servidor deriva a clínica a partir da chave.

Com ela é possível:

listar e atualizar contatos do funil;
mover cards no Kanban;
ler e configurar campanhas de follow-up;
consultar anúncios, links, tags, serviços e agendamentos;
registrar e consultar vendas de um contato, com valor, serviço e data do faturamento;
ler dados da conta e da assinatura.
acompanhar retornos programados, incluindo tarefas de IA com permissões próprias.

Como começar#

No CRM, abra Configurações → API com o usuário dono da clínica.
Crie uma chave (preset Somente leitura para o primeiro teste).
Copie o segredo na hora — ele aparece uma única vez.
Chame a API só do seu servidor, no cabeçalho Authorization: Bearer ....

Guia passo a passo: Início rápido.

URL base#

text

https://api.crm.agenciagens.com.br/v1

Exemplo:

http

GET /contacts?limit=5
Authorization: Bearer ck_live_...

O que a V1 não faz#

A V1 não oferece acesso geral a prontuários, conversas, arquivos, envio de mensagens, segredos ou cobrança. Há uma exceção restrita para o contexto de retornos, que pode incluir mensagens de texto. Veja Fora da V1.

Contrato técnico#

As rotas vigentes estão no OpenAPI 3.1 e na referência.

Para agentes: consulte o índice de integração e as regras de operação MCP. Some a URL base ao caminho da operação uma única vez: não use /v1/v1.