Primeira chamada em 5 minutos

Pro e FullAtualizado em 11/10/2026

Uma chamada de teste que lista 5 contatos da sua conta. Se ela responder, token, escopo e headers estão certos, e o resto da integração é só repetir o padrão.

O que você precisa

Um token com o escopo contacts.readonly (ou contacts.write).
O ID da sua conta: em Configurações > Perfil da empresa, no topo do bloco Informações gerais, copie o valor de ID de localização (tem um ícone de copiar ao lado). É uma sequência de 20 letras e números.

A chamada

Troque SEU_TOKEN e ID_DA_CONTA e rode no terminal:

curl "https://services.leadconnectorhq.com/contacts/?locationId=ID_DA_CONTA&limit=5" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Version: 2021-07-28" \
  -H "Accept: application/json"

Toda chamada à API leva esses dois headers:

Header	Valor	Pra que serve
`Authorization`	`Bearer` + o token	Identifica a sua integração
`Version`	`2021-07-28`	Fixa a versão da API. Sem ele a chamada falha

A resposta

{
  "contacts": [
    {
      "id": "ocQHyuzHvysMo5N5VsXc",
      "locationId": "ID_DA_CONTA",
      "firstName": "Maria",
      "lastName": "Souza",
      "email": "maria@exemplo.com.br",
      "phone": "+5524999990000",
      "tags": ["site", "lead-quente"],
      "dateAdded": "2026-10-02T14:21:07.000Z"
    }
  ],
  "meta": { "total": 1832, "nextPageUrl": "..." }
}

Telefone vem sempre no formato internacional, com +55. Datas vêm em UTC.

Se não funcionou

Resposta	Causa mais provável	O que fazer
`401`	Token errado, com espaço sobrando ou revogado	Copie de novo. Se o token foi apagado, crie outro
`401` com menção a escopo	O token não tem `contacts.readonly`	Edite a integração e marque o escopo
`400` mencionando versão	Faltou o header `Version`	Adicione exatamente `Version: 2021-07-28`
`404` ou lista vazia	`locationId` de outra conta	Confira o ID de localização em Perfil da empresa
`429`	Passou do limite de chamadas	Veja Limites de uso

Lista completa em Entender o erro.

Em JavaScript

const resposta = await fetch(
  `https://services.leadconnectorhq.com/contacts/?locationId=${process.env.A4S_CONTA}&limit=5`,
  { headers: { Authorization: `Bearer ${process.env.A4S_TOKEN}`, Version: '2021-07-28', Accept: 'application/json' } }
);
if (!resposta.ok) throw new Error(`API respondeu ${resposta.status}`);
const { contacts } = await resposta.json();
console.log(contacts.map((c) => `${c.firstName} ${c.phone}`));

Token e ID ficam em variável de ambiente, nunca no código. Mais em Guardar e trocar o token.

Próximos passos

Mapa de endpoints por tarefa: qual chamada faz o quê.
Criar ou atualizar contato sem duplicar: a primeira escrita que todo mundo precisa.