Overview

A API HubSpot da V4 Marketing fornece acesso aos dados do HubSpot CRM: contatos, deals, empresas, pipelines e produtos sincronizados das contas HubSpot conectadas ao seu workspace. Todos os endpoints usam o prefixo /v1/hubspot e seguem os mesmos padrões de autenticação, paginação e resposta da plataforma.

Endpoints disponíveis

Contatos

GET /v1/hubspot/contacts – Contatos com perfil, estágio de lifecycle, fonte de analytics e empresa associada

Deals

GET /v1/hubspot/deals – Deals com valor, estágio, pipeline, data de fechamento e associações (empresas, contatos, itens)

Empresas

GET /v1/hubspot/companies – Empresas com nome e data da última alteração

Pipelines

GET /v1/hubspot/pipelines – Pipelines com estágios e ordem de exibição

Produtos

GET /v1/hubspot/products – Produtos com nome, preço, descrição e SKU

Autenticação

Inclua as credenciais em todas as requisições através dos cabeçalhos HTTP obrigatórios:

Parâmetros comuns

workspaceId (obrigatório) – Workspace que possui a integração HubSpot

organizationId – Escopo da organização (opcional)

integrationId – ID da integração (opcional)

integrationName – Nome da integração (opcional)

page – Número da página (padrão: 1)

limit – Registros por página (padrão: 500, máx.: 5000)

createdStart / createdEnd – Filtro por data de criação (ISO 8601)

lastModifiedStart / lastModifiedEnd – Filtro por data da última alteração (ISO 8601)

Filtros por recurso

Contatos (`/v1/hubspot/contacts`)

id, email – Filtro por contato

lifecycleStage – Estágio do lifecycle (ex.: lead, opportunity, customer)

company – Nome da empresa associada

Deals (`/v1/hubspot/deals`)

id – ID do deal

dealStage – Estágio do deal (ex.: closedwon, closedlost)

pipeline – Nome do pipeline

dealName – Nome do deal

Empresas (`/v1/hubspot/companies`)

id – ID da empresa

name – Nome da empresa

Pipelines (`/v1/hubspot/pipelines`)

id – ID do pipeline

label – Rótulo do pipeline

Produtos (`/v1/hubspot/products`)

id – ID do produto

name – Nome do produto

hsSku – SKU no HubSpot

Formato da resposta

Todas as respostas seguem o formato padrão:

{
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 500,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Destaques do modelo de dados HubSpot

Contatos

Identidade: id, first_name, last_name, email, company, associated_company_id

Lifecycle: lifecycle_stage, create_date, first_conversion_date, first_deal_created_date, close_date

Analytics: hs_analytics_source, hs_analytics_last_touch_converting_campaign, hs_latest_source_*

Datas: created_at, updated_at, last_modified_date, inserted_at

Deals

Valor: amount, amount_in_home_currency, deal_currency_code, hs_closed_amount, hs_forecast_amount

Estágio: deal_stage, pipeline, hs_is_closed, hs_is_closed_won, hs_is_closed_lost

Datas: close_date, create_date, hs_closed_won_date, hs_lastmodifieddate

Associações: assoc_company_ids, assoc_contact_ids, assoc_line_item_ids

Responsável: hubspot_owner_id, hs_created_by_user_id, hs_updated_by_user_id

Empresas

Identidade: id, name

Datas: created_at, updated_at, hs_lastmodifieddate, inserted_at

Pipelines

Identidade: id, label, display_order

Configuração: stages (array de estágios com id, label, etc.)

Datas: created_at, updated_at, inserted_at

Produtos

Identidade: id, name, hs_sku, description

Comércio: price

Datas: created_at, updated_at, inserted_at

Endpoints disponíveis#

Contatos#

Deals#

Empresas#

Pipelines#

Produtos#

Autenticação#

Parâmetros comuns#

Filtros por recurso#

Contatos (/v1/hubspot/contacts)#

Deals (/v1/hubspot/deals)#

Empresas (/v1/hubspot/companies)#

Pipelines (/v1/hubspot/pipelines)#

Produtos (/v1/hubspot/products)#

Formato da resposta#

Destaques do modelo de dados HubSpot#

Contatos#

Deals#

Empresas#

Pipelines#

Produtos#

Endpoints disponíveis

Contatos

Deals

Empresas

Pipelines

Produtos

Autenticação

Parâmetros comuns

Filtros por recurso

Contatos (`/v1/hubspot/contacts`)

Deals (`/v1/hubspot/deals`)

Empresas (`/v1/hubspot/companies`)

Pipelines (`/v1/hubspot/pipelines`)

Produtos (`/v1/hubspot/products`)

Formato da resposta

Destaques do modelo de dados HubSpot

Contatos

Deals

Empresas

Pipelines

Produtos