HubSpot

Consultar e atualizar dados do HubSpot CRM ou iniciar fluxos a partir de eventos do HubSpot.

Integrações e ferramentasVendas e CRMConexão: OAuth

O que faz

Integre o HubSpot ao seu fluxo e aos seus agentes. Busque, crie e atualize contatos, empresas, negócios, tickets, notas e outros objetos do CRM. Conecte a conta do HubSpot com um clique ou use o token de um app privado guardado como segredo do workspace.

Quando usar: Use quando o seu fluxo precisar consultar e atualizar dados do HubSpot CRM ou iniciar fluxos a partir de eventos do HubSpot.

Exemplo de situação: Encontrar um cliente e registrar o resultado do atendimento no funil.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

Adicione HubSpot ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Escolha a operação. O painel mostra só os campos que essa operação usa.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Operações

Operação	O que faz
Obter contatos	Obtém contatos com o bloco HubSpot.
Criar contato	Cria contato com o bloco HubSpot.
Atualizar contato	Atualiza contato com o bloco HubSpot.
Buscar contatos	Busca contatos com o bloco HubSpot.
Obter empresas	Obtém empresas com o bloco HubSpot.
Criar empresa	Cria empresa com o bloco HubSpot.
Atualizar empresa	Atualiza empresa com o bloco HubSpot.
Buscar empresas	Busca empresas com o bloco HubSpot.
Obter negócios	Obtém negócios com o bloco HubSpot.
Criar negócio	Cria negócio com o bloco HubSpot.
Atualizar negócio	Atualiza negócio com o bloco HubSpot.
Buscar negócios	Busca negócios com o bloco HubSpot.
Obter tickets	Obtém tickets com o bloco HubSpot.
Criar ticket	Cria ticket com o bloco HubSpot.
Atualizar ticket	Atualiza ticket com o bloco HubSpot.
Buscar tickets	Busca tickets com o bloco HubSpot.
Obter notas	Obtém notas com o bloco HubSpot.
Criar nota	Cria nota com o bloco HubSpot.
Buscar notas	Busca notas com o bloco HubSpot.
Obter e-mails	Obtém e-mails com o bloco HubSpot.
Registrar e-mail	Registra e-mail com o bloco HubSpot.
Buscar e-mails	Busca e-mails com o bloco HubSpot.
Obter propriedades	Obtém propriedades com o bloco HubSpot.
Listar associações	Lista associações com o bloco HubSpot.
Criar associação	Cria associação com o bloco HubSpot.
Obter itens de linha	Obtém itens de linha com o bloco HubSpot.
Criar item de linha	Cria item de linha com o bloco HubSpot.
Atualizar item de linha	Atualiza item de linha com o bloco HubSpot.
Obter cotações	Obtém cotações com o bloco HubSpot.
Obter compromissos	Obtém compromissos com o bloco HubSpot.
Criar compromisso	Cria compromisso com o bloco HubSpot.
Atualizar compromisso	Atualiza compromisso com o bloco HubSpot.
Obter carrinhos	Obtém carrinhos com o bloco HubSpot.
Listar proprietários	Lista proprietários com o bloco HubSpot.
Obter eventos de marketing	Obtém eventos de marketing com o bloco HubSpot.
Obter listas	Obtém listas com o bloco HubSpot.
Criar lista	Cria lista com o bloco HubSpot.
Obter usuários	Obtém usuários com o bloco HubSpot.

Campos

Mostrar campos de

Operação
Escolhe qual ação este bloco executará.
Opções:
Obter contatos · Criar contato · Atualizar contato · Buscar contatos · Obter empresas · Criar empresa · Atualizar empresa · Buscar empresas · Obter negócios · Criar negócio · Atualizar negócio · Buscar negócios · Obter tickets · Criar ticket · Atualizar ticket · Buscar tickets · Obter notas · Criar nota · Buscar notas · Obter e-mails · Registrar e-mail · Buscar e-mails · Obter propriedades · Listar associações · Criar associação · Obter itens de linha · Criar item de linha · Atualizar item de linha · Obter cotações · Obter compromissos · Criar compromisso · Atualizar compromisso · Obter carrinhos · Listar proprietários · Obter eventos de marketing · Obter listas · Criar lista · Obter usuários
Padrão:
Obter contatos
Como conectar
Obrigatório
Escolhe uma das opções aceitas por este campo.
Opções:
Conta do HubSpot · Token de app privado
Padrão:
Conta do HubSpot
Conta do HubSpot
Obrigatório conforme a operação
Seleciona a conta já conectada que autoriza o acesso ao serviço.
Quando aparece:
Quando o campo “Como conectar” for “Conta do HubSpot”
Exemplo:
(escolha a conta conectada)
Token do app privado do HubSpot
Obrigatório conforme a operaçãoDado protegido
No HubSpot: Configurações → Integrações → Apps privados. Libere só os escopos que o fluxo usa (ex.: crm.objects.contacts.read e .write).
Quando aparece:
Quando o campo “Como conectar” for “Token de app privado”
Padrão:
Segredo protegido
Conta do HubSpot
Obrigatório conforme a operaçãoEm campos adicionais
Informa manualmente a credencial usada pela integração no modo avançado.
Quando aparece:
Quando o campo “Como conectar” for “Conta do HubSpot”
ID ou e-mail do contato
Deixe vazio para listar todos os contatos.
Aparece em:
Obter contatos
Exemplo:
id-do-recurso
ID ou domínio da empresa
Deixe vazio para listar todas as empresas.
Aparece em:
Obter empresas
Exemplo:
id-do-recurso
ID do negócio
Deixe vazio para listar todos os negócios.
Aparece em:
Obter negócios
Exemplo:
id-do-recurso
ID do ticket
Deixe vazio para listar todos os tickets.
Aparece em:
Obter tickets
Exemplo:
id-do-recurso
ID da nota
Deixe vazio para listar todas as notas.
Aparece em:
Obter notas
Exemplo:
id-do-recurso
ID do e-mail
Deixe vazio para listar todos os e-mails.
Aparece em:
Obter e-mails
Exemplo:
id-do-recurso
Tipo de objeto
Obrigatório conforme a operação
Tipo de objeto do HubSpot em que a operação atua, com o nome em inglês usado pela API (ex.: contacts, companies, deals ou tickets).
Aparece em:
Obter propriedades, Listar associações, Criar associação
Exemplo:
"contacts", "companies", "deals", "tickets"
Nome da propriedade
Deixe vazio para retornar todas as propriedades (ex.: "hs_lead_status").
Aparece em:
Obter propriedades
Exemplo:
Exemplo de atendimento
Somente arquivadas
Em campos adicionais
Define se este comportamento fica ativado ou desativado.
Aparece em:
Obter propriedades
Opções:
Não · Sim
Padrão:
Não
ID do registro
Obrigatório conforme a operação
ID do registro de origem.
Aparece em:
Listar associações, Criar associação
Exemplo:
id-do-recurso
Tipo de objeto de destino
Obrigatório conforme a operação
Tipo de objeto do outro lado da associação, ou seja, ao qual o registro será ligado ou cujos vínculos serão listados (ex.: notes, emails ou contacts).
Aparece em:
Listar associações, Criar associação
Exemplo:
"emails", "notes", "contacts"
ID do registro de destino
Obrigatório conforme a operação
ID do registro de destino.
Aparece em:
Criar associação
Exemplo:
id-do-recurso
Categoria da associação
Em campos adicionais
Escolhe uma das opções aceitas por este campo.
Aparece em:
Criar associação
Opções:
Definida pelo HubSpot · Definida pelo usuário · Definida pelo integrador
Padrão:
Definida pelo HubSpot
ID do tipo de associação
Em campos adicionais
Deixe vazio para usar a associação padrão (ex.: 198 = e-mail→contato).
Aparece em:
Criar associação
Exemplo:
id-do-recurso
ID do item de linha
Deixe vazio para listar todos os itens de linha.
Aparece em:
Obter itens de linha
Exemplo:
id-do-recurso
ID da cotação
Deixe vazio para listar todas as cotações.
Aparece em:
Obter cotações
Exemplo:
id-do-recurso
ID do compromisso
Deixe vazio para listar todos os compromissos.
Aparece em:
Obter compromissos
Exemplo:
id-do-recurso
ID do carrinho
Deixe vazio para listar todos os carrinhos.
Aparece em:
Obter carrinhos
Exemplo:
id-do-recurso
ID do evento de marketing
Deixe vazio para listar todos os eventos de marketing.
Aparece em:
Obter eventos de marketing
Exemplo:
id-do-recurso
ID da lista
Deixe vazio para buscar em todas as listas.
Aparece em:
Obter listas
Exemplo:
id-do-recurso
Nome da lista
Obrigatório conforme a operação
Nome da nova lista.
Aparece em:
Criar lista
Exemplo:
Exemplo de atendimento
ID do tipo de objeto
Obrigatório conforme a operação
Informa o identificador exato do recurso na plataforma conectada.
Aparece em:
Criar lista
Exemplo:
id-do-recurso
Tipo de processamento
Obrigatório conforme a operação
Escolhe uma das opções aceitas por este campo.
Aparece em:
Criar lista
Opções:
Manual (estática) · Dinâmica (ativa)
Exemplo:
Manual (estática)
Propriedade de ID
Obrigatória ao usar e-mail/domínio (ex.: "email" ou "domain").
Aparece em:
Obter contatos, Atualizar contato, Obter empresas, Atualizar empresa, Obter negócios, Atualizar negócio, Obter tickets, Atualizar ticket, Obter itens de linha, Atualizar item de linha, Obter cotações, Obter compromissos, Atualizar compromisso
Exemplo:
"email" ou "domain"
Propriedades
Obrigatório conforme a operação
Objeto JSON com as propriedades do registro no HubSpot, usando os nomes internos das propriedades (ex.: email, firstname, phone) e os valores a gravar.
Aparece em:
Criar contato, Atualizar contato, Criar empresa, Atualizar empresa, Criar negócio, Atualizar negócio, Criar ticket, Atualizar ticket, Criar item de linha, Atualizar item de linha, Criar compromisso, Atualizar compromisso, Criar nota, Registrar e-mail
Exemplo:
{"email": "teste@exemplo.com", "firstname": "João"}
Propriedades a retornar
Em campos adicionais
Lista separada por vírgulas (ex.: "email,firstname,lastname").
Aparece em:
Obter contatos, Obter empresas, Obter negócios, Obter tickets, Obter notas, Obter e-mails, Obter itens de linha, Obter cotações, Obter compromissos, Obter carrinhos, Obter usuários
Exemplo:
{ "chave": "valor" }
Associações
Em campos adicionais
Tipos de objeto separados por vírgulas (ex.: "companies,deals").
Aparece em:
Obter contatos, Obter empresas, Obter negócios, Obter tickets, Obter notas, Obter e-mails, Obter itens de linha, Obter cotações, Obter compromissos, Obter carrinhos, Criar contato, Criar empresa, Criar negócio, Criar ticket, Criar item de linha, Criar compromisso, Criar nota, Registrar e-mail
Exemplo:
"companies,deals"
Resultados por página
Em campos adicionais
Define um valor numérico, quantidade ou limite da operação.
Aparece em:
Obter usuários, Obter contatos, Obter empresas, Obter negócios, Obter tickets, Obter notas, Obter e-mails, Obter itens de linha, Obter cotações, Obter compromissos, Obter carrinhos, Listar proprietários, Listar associações, Obter eventos de marketing, Obter listas, Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails
Exemplo:
10
Cursor de paginação
Em campos adicionais
Cursor de paginação vindo de paging.next.after na resposta anterior.
Aparece em:
Obter contatos, Obter empresas, Obter negócios, Obter tickets, Obter notas, Obter e-mails, Obter itens de linha, Obter cotações, Obter compromissos, Obter carrinhos, Listar proprietários, Listar associações, Obter usuários, Obter eventos de marketing, Obter listas, Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails
Exemplo:
Cursor de paginação vindo de paging.next.after na resposta anterior
Consulta de busca
Informa a consulta usada para localizar ou transformar dados.
Aparece em:
Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails, Obter listas
Exemplo:
SELECT * FROM clientes WHERE status = 'ativo'
Grupos de filtros
Define a consulta ou o filtro aplicado aos dados.
Aparece em:
Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails
Exemplo:
status = 'ativo'
Ordem
Em campos adicionais
Lista em JSON com a ordem dos resultados da busca: nome interno da propriedade e direção ASCENDING ou DESCENDING (ex.: createdate DESCENDING para os mais recentes primeiro).
Aparece em:
Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails
Exemplo:
[{"propertyName":"createdate","direction":"DESCENDING"}]
Propriedades a retornar
Em campos adicionais
Define a consulta ou o filtro aplicado aos dados.
Aparece em:
Buscar contatos, Buscar empresas, Buscar negócios, Buscar tickets, Buscar notas, Buscar e-mails
Exemplo:
{ "chave": "valor" }

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <hubspot.users>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<hubspot.users>`	json	Lista de usuários.
`<hubspot.contacts>`	json	Lista de objetos de contato.
`<hubspot.contact>`	json	Um único contato.
`<hubspot.companies>`	json	Lista de empresas.
`<hubspot.company>`	json	Uma única empresa.
`<hubspot.deals>`	json	Lista de negócios.
`<hubspot.deal>`	json	Um único negócio.
`<hubspot.tickets>`	json	Lista de tickets.
`<hubspot.ticket>`	json	Um único ticket.
`<hubspot.lineItems>`	json	Lista de itens de linha.
`<hubspot.lineItem>`	json	Um único item de linha.
`<hubspot.quotes>`	json	Lista de cotações.
`<hubspot.quote>`	json	Uma única cotação.
`<hubspot.appointments>`	json	Lista de compromissos.
`<hubspot.appointment>`	json	Um único compromisso.
`<hubspot.carts>`	json	Lista de carrinhos.
`<hubspot.cart>`	json	Um único carrinho.
`<hubspot.owners>`	json	Lista de proprietários.
`<hubspot.events>`	json	Lista de eventos de marketing.
`<hubspot.event>`	json	Um único evento de marketing.
`<hubspot.lists>`	json	Lista de listas.
`<hubspot.list>`	json	Uma única lista.
`<hubspot.notes>`	json	Lista de notas.
`<hubspot.note>`	json	Uma única nota.
`<hubspot.emails>`	json	Lista de atividades de e-mail.
`<hubspot.email>`	json	Uma única atividade de e-mail.
`<hubspot.properties>`	json	Lista de definições de propriedades (name, label, type, fieldType, options).
`<hubspot.results>`	json	Lista de registros associados (toObjectId, associationTypes).
`<hubspot.fromObjectId>`	string	ID do registro de origem (ao criar associação).
`<hubspot.toObjectId>`	string	ID do registro de destino associado (ao criar associação).
`<hubspot.labels>`	json	Rótulos da associação (ao criar associação e ao obter rótulos de associação).
`<hubspot.deleted>`	boolean	Indica se o registro foi arquivado (ao excluir).
`<hubspot.memberships>`	json	Lista dos registros que fazem parte da lista (recordId, membershipTimestamp).
`<hubspot.recordIdsAdded>`	json	IDs dos registros adicionados à lista.
`<hubspot.recordIdsRemoved>`	json	IDs dos registros removidos da lista.
`<hubspot.recordIdsMissing>`	json	IDs de registros solicitados que não foram encontrados.
`<hubspot.total>`	number	Total de resultados encontrados (na busca).
`<hubspot.paging>`	json	Informações de paginação com os cursores next/prev.
`<hubspot.metadata>`	json	Metadados da operação.
`<hubspot.success>`	boolean	Indica se a operação foi concluída com sucesso.

Exemplo de uso

Objetivo: Encontrar um cliente e registrar o resultado do atendimento no funil.

InícioHubSpotpróxima etapa

Operação: Obter contatos
Como conectar: Conta do HubSpot
Conta do HubSpot: (escolha a conta conectada)
ID ou e-mail do contato: id-do-recurso
Propriedade de ID: "email" ou "domain"

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte: Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <hubspot.users>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece: Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403): A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro: Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

O que faz

Antes de começar

Passo a passo

Operações

Campos

Operação

Como conectar

Conta do HubSpot

Token do app privado do HubSpot

Conta do HubSpot

ID ou e-mail do contato

ID ou domínio da empresa

ID do negócio

ID do ticket

ID da nota

ID do e-mail

Tipo de objeto

Nome da propriedade

Somente arquivadas

ID do registro

Tipo de objeto de destino

ID do registro de destino

Categoria da associação

ID do tipo de associação

ID do item de linha

ID da cotação

ID do compromisso

ID do carrinho

ID do evento de marketing

ID da lista

Nome da lista

ID do tipo de objeto

Tipo de processamento

Propriedade de ID

Propriedades

Propriedades a retornar

Associações

Resultados por página

Cursor de paginação

Consulta de busca

Grupos de filtros

Ordem

Propriedades a retornar

Saídas

Exemplo de uso

Erros comuns e como resolver

Blocos relacionados