HubSpot – Gotchas
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
activitiesAllHubspot 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.
activitiesUpdateTo update custom fields for call activities, use `"type": "call"` in the request body.
Companies1 gotcha
companiesAllWhen using a filter or sorting for companies, Hubspot will only return a maximum of 10.000 companies.
Contacts2 gotchas
contactsAllWhen using a filter or sorting for contacts, Hubspot will only return a maximum of 10.000 contacts.
contactsAddWhen 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
leadsAllWhen using a filter or sorting for leads, Hubspot will only return a maximum of 10.000 leads.
leadsAddWhen 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).
Opportunities1 gotcha
opportunitiesAllWhen 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
usersAllHubSpot 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.