HubSpot – Gotchas

Service ID: hubspot

HubSpot is your all-in-one stop for all of your marketing software needs.

⚠️

9 gotchas across 6 resources

These are connector-specific behaviors and limitations to be aware of when integrating.

Activities2 gotchas

allactivitiesAll

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](https://legacydocs.hubspot.com/docs/methods/engagements/get-recent-engagements). 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.

updateactivitiesUpdate

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

Companies1 gotcha

allcompaniesAll

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

Contacts2 gotchas

allcontactsAll

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

addcontactsAdd

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](https://developers.hubspot.com/docs/api/crm/contacts).

Leads2 gotchas

allleadsAll

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

addleadsAdd

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](https://developers.hubspot.com/docs/api/crm/contacts).

allopportunitiesAll

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.

Users1 gotcha

allusersAll

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.