Como Criar Contatos e Leads pela API

Bem-vindo à documentação oficial da API Groner. Utilize nossos endpoints para integrar seus sistemas externos e automatizar seu fluxo de vendas.

💡 Lembre-se: cada cliente possui um subdomínio próprio. Substitua {subdominio} na URL base pela identificação da sua conta.

1. Autenticação (Gerar Chave)

Acesse o painel da Groner e siga o caminho abaixo para gerar seu token (chave) manualmente. Este token tem validade de 1 ano e deve ser enviado no header de todas as requisições.

Passo a passo:

1. No menu lateral, clique em Configurações;
2. Vá em Sistema & Desenvolvedor > Integrações;
3. Clique na aba Gerar Token;
4. A Referência será puxada de forma automática, se não puxar, só inserir manualmente (ex: "Integração Site") e sua Senha de acesso;
5. Clique em Gerar Token;

Resposta de Sucesso:

{
  "access_token": "eyJhbGciOiJIUzI1...",
  "expires_in": 31536000,
  "token_type": "Bearer"
}

2. Criar um Contato (Lead/Oportunidade)

Este endpoint permite cadastrar novos leads ou contatos comerciais na plataforma.

POST https://{subdominio}.api.groner.app/api/lead

Exemplo de Requisição (cURL):

BASH / CURLCopiar

curl 'https://subdominio.api.groner.app/api/lead' \
  -H 'authorization: Bearer SEU_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{
    "tipo": "PJ",
    "nome": "TESTE",
    "celular": "(00) 00000-0000",
    "email": "teste@teste.com",
    "origemId": 20,
    "criarProjeto": false
  }'

3. Criar um Negócio (Projeto)

Crie um novo projeto ou oportunidade de negócio associado a um lead existente.

POST https://{subdominio}.api.groner.app/api/projeto

Exemplo de Requisição (cURL):

BASH / CURLCopiar

curl 'https://subdominio.api.groner.app/api/projeto' \
  -H 'authorization: Bearer SEU_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{
    "nome": "TESTE",
    "statusId": 94,
    "leadId": 151,
    "origemId": 1,
    "usuarioId": 1,
    "tipoProjetoId": 10
  }'

Atualizado em: 12/03/2026