HubSpot

Contatos

GET
/v1/hubspot/contacts

Retorna contatos do CRM do HubSpot com estágio do ciclo de vida e atribuição de analytics.

Filtros:

  • organizationId (obrigatório)
  • integrationId, integrationName (opcional)
  • id, email – filtra por contato específico
  • lifecycleStage – estágio do ciclo de vida (ex.: lead, opportunity, customer)
  • createdStart, createdEnd – intervalo de data de criação
  • lastModifiedStart, lastModifiedEnd – intervalo de data da última atualização
  • page, limit – paginação

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

integrationId?string

Identificador da integração (opcional)

integrationName?string

Nome da integração (opcional)

id?string

ID do contato (opcional)

email?string

E-mail do contato (opcional)

lifecycleStage?string

Estágio do ciclo de vida (opcional)

createdStart?string

Data/hora inicial do filtro de criação (opcional, ISO 8601)

Formatodate-time
createdEnd?string

Data/hora final do filtro de criação (opcional, ISO 8601)

Formatodate-time
lastModifiedStart?string

Data/hora inicial do filtro de última atualização (opcional, ISO 8601)

Formatodate-time
lastModifiedEnd?string

Data/hora final do filtro de última atualização (opcional, ISO 8601)

Formatodate-time
page?integer

Número da página (opcional)

Padrão1
limit?integer

Itens por página (opcional, máx. 5000)

Intervalovalue <= 5000
Padrão500

Corpo da resposta

Resposta de sucesso

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/hubspot/contacts?organizationId=organization_123&createdStart=2026-01-01T00%3A00%3A00Z&createdEnd=2026-01-31T23%3A59%3A59Z&lastModifiedStart=2026-01-01T00%3A00%3A00Z&lastModifiedEnd=2026-01-31T23%3A59%3A59Z"
{  "data": [    {      "id": "string",      "associated_company_id": "string",      "close_date": "2019-08-24T14:15:22Z",      "create_date": "2019-08-24T14:15:22Z",      "email": "string",      "first_deal_created_date": "2019-08-24T14:15:22Z",      "hs_analytics_source": "string",      "hs_analytics_source_data_1": "string",      "hs_analytics_source_data_2": "string",      "hs_latest_source_data_1": "string",      "hs_latest_source_data_2": "string",      "hs_latest_source_timestamp": "2019-08-24T14:15:22Z",      "last_modified_date": "2019-08-24T14:15:22Z",      "lifecycle_stage": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "archived": true,      "integration_id": "string",      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "inserted_at": "2019-08-24T14:15:22Z",      "integration_name": "string"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}