Quick start

Em menos de 5 minutos você cria uma API Key e faz sua primeira chamada — listando os contatos do seu CRM.

1. Gere uma API Key

   No CRM, vá em Configurações → Integrações → API Keys → Nova API Key. Dê um nome (“Teste integração”), marque o scope contacts:read e clique em Criar.

   A chave aparece uma única vez na tela seguinte — copie e guarde num lugar seguro (cofre de senhas, secret manager). Depois disso só fica o hash no banco.

   Cuidado

   Se você fechar essa tela sem copiar, vai precisar gerar uma nova — não dá pra recuperar o segredo.

2. Faça a primeira chamada

   cURL

   curl https://app.indutivacrm.com.br/api/v1/contacts \
     -H "X-API-Key: crm_live_seu_segredo_aqui"

   Node.js (fetch)

   const res = await fetch('https://app.indutivacrm.com.br/api/v1/contacts', {
     headers: { 'X-API-Key': process.env.CRM_API_KEY },
   })
   const contacts = await res.json()
   console.log(contacts)

   Python (requests)

   import os, requests
   
   r = requests.get(
       'https://app.indutivacrm.com.br/api/v1/contacts',
       headers={'X-API-Key': os.environ['CRM_API_KEY']},
   )
   print(r.json())

   Se a chave estiver correta, você recebe 200 OK com um array de contatos do seu tenant.

3. Crie um contato

   Pra escrever, você precisa também do scope contacts:write. Gere uma key nova com os dois scopes ou edite a existente.

   cURL

   curl -X POST https://app.indutivacrm.com.br/api/v1/contacts \
     -H "X-API-Key: crm_live_seu_segredo_aqui" \
     -H "Content-Type: application/json" \
     -d '{
       "firstName": "Maria",
       "lastName": "Silva",
       "email": "maria@empresa.com.br",
       "phone": "+5511999999999"
     }'

   Node.js

   const res = await fetch('https://app.indutivacrm.com.br/api/v1/contacts', {
     method: 'POST',
     headers: {
       'X-API-Key': process.env.CRM_API_KEY,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       firstName: 'Maria',
       lastName: 'Silva',
       email: 'maria@empresa.com.br',
       phone: '+5511999999999',
     }),
   })

Próximos passos

• Entenda os Scopes (permissões) — controle granular do que cada chave acessa
• Veja os Endpoints disponíveis — referência completa por recurso
• Configure rate limit por chave (default 100 req/min)
• Saiba lidar com erros — status codes e códigos padronizados