Duplicate associations?

Developer Support APIs & Integrations
1

Does the HubSpot CRM have built-in logic to prevent duplicate associations from being created?

What I mean is this: I have a nightly job that executes, pulling customer/loan/etc. data from a different external system. For each incoming record, the code creates the new record in HubSpot if it doesn’t exist (based on key fields I’ve identified), otherwise it updates it.

The job’s code also creates the needed associations: for each loan, after creating or updating it, it creates an association between the loan and its related customer (using the PUT method described in your documentation here). For example:

/crm/v4/objects/contacts/12345/associations/loans/67890

My question is: what if a contact-to-loan association already exists between the contact with ID 12345 and the loan with ID 67890? Does HubSpot create a brand new (duplicate) association? Does it return an error/exception? Or does it merely not create the association and exit quietly?

2

In my testing, if the association already exists for those two objects, it’ll work fine. It’s important to note that the association can have multiple association labels which is the default case for Companies as there can be a Primary and other custom defined ones.

If a Contact → Company association exists and your API call is only providing a single user defined association label, it will clear the Primary association. In other words, it’s not appending to the array of association labels, it’s replacing it. This would be the case if you are using multiple association labels for other associations in your portal.

So just ensure you are providing ALL of the assoication types everytime you run a PUT.

3

Thanks @LeeBartelme - this answers my question