The API documentation for Contacts says, "the primary key for a contact in the HubSpot system is an email address".
But there are API methods which allow updating the email address of a contact - although this can't be done by email, but using the "vid".
So the vid appears to be the actual PK. But when you create contacts (in bulk at least) you are not told the vid. You would have to fetch the vid by email, and then update by vid.
From this, I have questions:
- Is it possible to specify an id field to be the PK of a contact, or can it only be the vid?
- Are we expected to store the Hubspot vid in our own system to facilitate synchronisation and lookups?
- Can a contact have more than one email address? (For example, home and work)