Skip to content

HubSpot query parameters

This article describes the API request parameters used by the HubSpot connector to retrieve data.

Main parameters

HubSpot API parameters: limit (up to 100), after (pagination cursor), properties (list of requested properties), filterGroups (search filters), sorts (sorting). Cursor-based pagination is used.

Pagination

LightLead automatically manages pagination when loading large volumes of data. Pagination types:

TypeDescriptionParameters
Page-based (offset)Page-by-page loadingpage/limit or offset/limit
Cursor-basedLoading via cursorafter/next_page_token
Time-basedLoading by date rangedate_from/date_to

Limit management

For optimal performance, consider:

  • Page size: the optimal size depends on the volume of data in the fields

  • Request frequency: respect the CRM's rate limits

  • Parallel requests: requests are executed sequentially where possible

  • Caching: frequently requested data is cached

Error handling

When limits are exceeded or timeouts occur, LightLead applies:

  1. Automatic retry — request retry with exponential backoff

  2. Partial loading — preserving already received data if interrupted

  3. Notification — informing the user about sync issues

Maintained by the LightLead Documentation Team · Last verified: 2026-07-25