V4MOS.AI API
GuiasReferência da APIapp.v4mos.ai
HubSpot

Negócios

GET
/v1/hubspot/deals

Retorna deals do CRM do HubSpot com valor, estágio, pipeline, datas e associações.

Filtros:

  • organizationId (obrigatório)
  • integrationId, integrationName (opcional)
  • id – ID do deal
  • dealStage – estágio do deal (ex.: closedwon, closedlost)
  • pipeline – nome do pipeline
  • dealName – nome do deal
  • 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 deal (opcional)

dealStage?string

Estágio do deal (opcional)

pipeline?string

Nome do pipeline (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/deals?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",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "archived": true,      "amount": 0,      "amount_in_home_currency": 0,      "close_date": "2019-08-24T14:15:22Z",      "create_date": "2019-08-24T14:15:22Z",      "days_to_close": "string",      "deal_currency_code": "string",      "deal_stage": "string",      "hs_closed_amount": 0,      "hs_closed_amount_in_home_currency": 0,      "hs_closed_won_date": "2019-08-24T14:15:22Z",      "hs_created_by_user_id": "string",      "hs_exchange_rate": 0,      "hs_forecast_amount": 0,      "hs_forecast_probability": "string",      "hs_is_closed": "string",      "hs_is_closed_lost": "string",      "hs_is_closed_won": "string",      "hs_lastmodifieddate": "2019-08-24T14:15:22Z",      "hs_primary_associated_company": "string",      "hs_updated_by_user_id": "string",      "hubspot_owner_id": "string",      "pipeline": "string",      "assoc_line_item_ids": [],      "assoc_company_ids": [],      "assoc_contact_ids": [],      "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  }}

Contatos GET

Página anterior

Empresas GET

Próxima página