Como criar propriedades personalizadas em massa no HubSpot a partir de um CSV ou planilha

Por Kayabyte · Atualizado em 4/11/2026

Você está configurando uma conta nova do HubSpot, talvez de um cliente, e precisa de 40 propriedades personalizadas com grupos e opções de lista suspensa. O HubSpot não tem um botão de “importar propriedades”. A comunidade pede isso há muito tempo, e em junho de 2026 um gerente de produto da HubSpot disse que não há planos para isso (tópico da comunidade). Estes são os caminhos que existem.

Caminho 1: criar uma por uma

Configurações > Propriedades > Criar propriedade. Escolha objeto, grupo, rótulo e tipo. O nome interno não pode ser alterado depois, então confira antes de salvar. Funciona para poucas. Em listas suspensas, Carregar opções cola uma lista inteira (guia da HubSpot).

Caminho 2: criar ao importar registros

Na etapa de mapeamento, Criar nova propriedade configura uma propriedade para uma coluna (guia da HubSpot). É uma por coluna, à mão, e serve para importar registros, não para preparar uma conta vazia. As opções de lista suspensa precisam existir antes da importação.

Caminho 3: a API de propriedades

A API do HubSpot tem um endpoint de criação em lote. Cada propriedade precisa de nome, rótulo, tipo, tipo de campo e grupo. Você precisa de um token de app privado com permissão de escrita no esquema e de um script que leia sua planilha. É o caminho mais flexível e também o que exige um desenvolvedor, e grupos, ordem das opções e erros ficam por sua conta.

Caminho 4: pedir a uma ferramenta de IA

O agente de dados e o Breeze Assistant do HubSpot podem criar uma propriedade a partir de uma descrição (guia da HubSpot). Ainda é uma de cada vez, então economiza cliques, não horas de configuração.

O que preparar na planilha

Uma linha por propriedade: objeto, nome interno, rótulo, tipo, tipo de campo, grupo e, nas listas suspensas, as opções com o valor interno desejado. Defina os valores internos agora, porque depois não dá para mudar.

Antes de importar, você pode verificar o arquivo com o verificador gratuito de CSV de propriedades (em inglês). Ele roda no navegador e nada é enviado. Aviso: fomos nós que criamos, assim como o app abaixo.

Aviso: criamos um app para isso

O Bulk Property Import & Export lê um CSV ou uma planilha pública do Google Sheets com uma linha por propriedade e mostra primeiro uma prévia do lote inteiro: o que será criado, atualizado ou mantido, com o motivo de cada linha com problema. Nada é gravado até você clicar em Apply. Ele também cria grupos, funciona com contatos, empresas e negócios e só pede acesso às configurações de propriedades, nunca aos seus registros. Não altera as propriedades padrão bloqueadas. O app e o suporte estão em inglês.

Importação, exportação e prévia são gratuitas. O Pro custa USD 19 por mês por conta HubSpot e o Agency USD 49 por mês para contas de clientes ilimitadas; toda conta nova tem 14 dias de teste do Pro sem cartão. Página no Marketplace.

Perguntas frequentes

Dá para importar propriedades personalizadas no HubSpot? Não com a ferramenta de importação do HubSpot, que importa registros. Use o endpoint em lote da API de propriedades ou um app.

Posso enviar um CSV para criar propriedades? Não de forma nativa. A API lê JSON; um app pode ler seu CSV e chamar a API para você.

Existe limite de opções de lista suspensa? A HubSpot documenta até 5.000 opções por propriedade.

Dúvidas ou correções: support@kayabyte.dev. HubSpot é uma marca registrada da HubSpot, Inc. A Kayabyte é uma desenvolvedora independente, sem afiliação com a HubSpot.