HubSpot – Gotchas

Hubspot will only return activities from the last 30 days when using the filter[updated_since] parameter, with a maximum of 10.000 records. More info here. Use filter[type]=call to get custom fields for call activities. When using both filter[type]=call and filter[updated_since] together, you will get partial response data as the calls search endpoint does not support many data fields. Use only one filter to get better data fields. filter[contact_id] returns all activity types (calls, emails, meetings, notes, and tasks) associated with the contact, served by HubSpot's legacy associated-engagements API. Two interactions to note: combining filter[contact_id] with filter[updated_since] is not supported — the contact filter takes precedence and the date filter is silently ignored (the associated-engagements endpoint has no date filter). And filter[type] narrows the result only when type=call (returning that contact's calls); any other type value is ignored and all activity types are still returned.

To update custom fields for call activities, use "type": "call" in the request body.

When using a filter or sorting for companies, Hubspot will only return a maximum of 10.000 companies.

When using a filter or sorting for contacts, Hubspot will only return a maximum of 10.000 contacts.

When creating a contact, it is advised to always include an unique email address since Hubspot uses it to prevent duplicate contacts in HubSpot. More info on the Hubspot developer docs.

When using a filter or sorting for leads, Hubspot will only return a maximum of 10.000 leads.

When creating a lead, it is advised to always include an unique email address since Hubspot uses it to prevent duplicate contacts in HubSpot. More info on the Hubspot developer docs.

HubSpot's Lists v3 API does not expose description, visibility, folder_id, owner_id, is_favorite, is_default, or is_system, and custom_fields and tags are not mapped, so these fields are not returned for HubSpot. filter_criteria is not mapped in v1 (HubSpot's filterBranch is available downstream via includeFilters=true but is not requested). HubSpot's three list processing types map onto type as follows: DYNAMIC lists are returned as dynamic; MANUAL and SNAPSHOT lists are both returned as static.

HubSpot's Lists v3 API does not expose description, visibility, folder_id, owner_id, is_favorite, is_default, or is_system, and custom_fields and tags are not mapped, so these fields are not returned for HubSpot. filter_criteria is not mapped in v1 (HubSpot's filterBranch is available downstream via includeFilters=true but is not requested). HubSpot's three list processing types map onto type as follows: DYNAMIC lists are returned as dynamic; MANUAL and SNAPSHOT lists are both returned as static. A list id that does not exist in HubSpot returns a 404 error from the downstream API.

Hubspot will only return activities from the last 30 days when using the filter[updated_since] parameter, with a maximum of 10.000 records. More info here. Use filter[type]=call to get custom fields for call activities. When using both filter[type]=call and filter[updated_since] together, you will get partial response data as the calls search endpoint does not support many data fields. Use only one filter to get better data fields.

When using a filter or sorting for opportunities, Hubspot will only return a maximum of 10.000 opportunities and omit the company_id, primary_contact_id, company_id, contact_ids, lead_id and contact_id.

HubSpot does not expose a cross-page total record count on this endpoint. meta.total_count will not appear.

HubSpot owners are mapped to CRM users in Apideck. HubSpot owners and HubSpot users (people who can log into HubSpot) aren't necessarily the same, as you may have owners created through an integration.