> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como criar leads (novos negócios) e contatos pela API

Bem-vindo à documentação oficial da API Groner. Utilize nossos endpoints para integrar seus sistemas externos e automatizar seu fluxo de [vendas](https://ajuda.groner.app/pt-br/article/o-que-e-uma-venda-na-groner-1s0sqzj/?ref=groner-suporte).
💡 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](https://ajuda.groner.app/pt-br/article/o-que-e-um-contato-1jnanrl/?ref=groner-suporte) 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](https://ajuda.groner.app/pt-br/article/o-que-e-um-negocio-1fi8lyn/?ref=groner-suporte) 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
  }'
```

| Aproveite pra já conferir como funcionará os seus [formulários](https://ajuda.groner.app/pt-br/article/o-que-e-um-formulario-e-como-ele-funciona-na-groner-17y9c1e/) na Groner CRM.