Pesquisas
Pesquisar contatos
Encontre contatos com filtros avançados, grupos lógicos, paginação e ordenação.
URL completa: https://services.leadconnectorhq.com/contacts/search
POST
cURL
Token e permissões: na Salez, acesse Configurações > Integrações Privadas para gerar ou gerenciar o token, conforme seu nível de acesso. Esta operação exige o escopo
contacts.readonly. Envie Authorization: Bearer <token> e Version: v3. O filtro filters aceita comparações e agrupamentos AND e OR. Veja a visão geral de Contatos.Como funcionam os filtros
O corpo da requisição recebe o identificador da subconta, a quantidade de registros e filtros opcionais. Emfilters, cada item pode ser um filtro de campo ou um grupo AND / OR de filtros.
AND, retornando contatos da cidade de São Paulo que também tenham a etiqueta cliente.
Campos mais utilizados
*O campo
contactName aceita igualdade e verificação de existência; os operadores de conteúdo são aplicáveis aos campos de nomes em letras minúsculas. Cada campo aceita somente os operadores habilitados para ele.
Para email e website, os operadores contains e not_contains não estão disponíveis. Os filtros email e phone consideram o valor principal do contato; para procurar também os adicionais, utilize o campo textual query ou a consulta de possível duplicado.
Campos personalizados
UtilizecustomFields.{customFieldId} no campo field do filtro. Os operadores aceitos dependem do tipo:
Para campos de lista de textos, utilize também
.{optionId} ao final do caminho.
Filtros de oportunidades
O filtroopportunities usa o operador nested e recebe uma lista de critérios sobre pipelineId, pipelineStageId ou status.
Paginação e ordenação
pageLimitaceita até 500 registros por requisição. Se definido como0, retorna apenas a contagem.pagecomeça em 1 e permite acessar até 10.000 resultados na paginação convencional.- Para ultrapassar esse limite, reutilize o
searchAfterdo último contato recebido na página anterior. Nesse modo,pageé ignorado. sortpermite até dois critérios, comodateAddedefirstNameLowerCase.- Com
fastPagination: true, a resposta informahasMoreem vez detotal.
Consultas podem apresentar um pequeno atraso de indexação após alterações recentes. Para sincronizações incrementais, use
dateUpdated com range, intervalos sobrepostos e deduplicação por id.Autorizações
Corpo
application/json
Última modificação em 20 de novembro de 2026

