topic Automatic association for Call engagement objects created using API in Sales Integrations

Automatic association for Call engagement objects created using API

sajjanstrings — Wed, 24 Aug 2022 05:59:59 GMT

Hi,

I wanted to understand how does the automatic association to open deals work specifically for call engagement created using API.

Example:

An api creates an engagement object linked to a contact names "Mark" and a company named "Acme".

If mark has only one open deal but acme has 5 open deals, how would the auto association work? Will this engagement be linked to all 5 deals?

Re: Automatic association for Call engagement objects created using API

coldrickjack — Wed, 24 Aug 2022 08:35:58 GMT

Hey @sajjanstrings,

The answer here is that it really depends on how you choose to integrate, it's certainly possible but not the default behaviour.

By default If an engagement (Call, Meeting, Task, Note, Email) is created via the CRM API and associated to a contact they will not be automatically associated to other records in the CRM as per this documentation. What needs to happen is that the integrator also makes a call to an endpoint to define additional associations to other objects.

Re: Automatic association for Call engagement objects created using API

sajjanstrings — Wed, 24 Aug 2022 09:29:31 GMT

what if we were creating it from the older API:

https://legacydocs.hubspot.com/docs/methods/engagements/create_engagement

Re: Automatic association for Call engagement objects created using API

coldrickjack — Wed, 24 Aug 2022 10:25:14 GMT

Hey @sajjanstrings,

The same applies, it won't automatically associate to other records. It will only associate to the records with the IDs you provide in your request.

Also, I'd recommend using the newer versions of the API as ultimately the legacy endpoints will be deprecated at some point.

Re: Automatic association for Call engagement objects created using API

sajjanstrings — Wed, 24 Aug 2022 10:35:25 GMT

I tried testing this and looks like Hubspot did auto associate an
engagement with a deal that I didn't explicitly ask it to associate the
engagement with.
It seems to look at all open deals for a contact and auto-linking to them
all.