Skip to content
HubSpot Developer Changelog

Increasing the size of contact record IDs

Beginning in March 2024, we'll be updating the system that generates contact record IDs. This will affect the id for the v3 Contacts API, the vid for the legacy Contacts API, and the hs_object_id property returned with either API.


What's changing?

Once this change goes into effect, the numbers generated for contact record IDs may be significantly higher than currently generated IDs. The new ID values will require 64 bit data types to store the ID as an integer value.

This update will bring contacts in line with all other CRM objects that already use the new system for generating IDs.

The IDs for existing contact records will not be changing. This will only affect the IDs for newly created contact records.


When is this happening?

The new system will start being used to generate IDs for new contact records on March 11, 2024.

Please let us know if you have any questions by joining the discussion in our community.