Track contacts add/remove from an engagement

Developer Support APIs & Integrations
1

Hello,

I would like to track when a contacts is added or removed from an existing engagment on a company.

When I create an engagement on a company:
(1) this endpoint “https://api.hubapi.com/engagements/v1/engagements/recent/modified” document here does not seems to report this update.
(2) I didn’t find a way through webhook also.

Does it exist a way to get this info easily?

Best regards,

etienne

2

Hey @etienne1,

Currently, there isn’t a way to track when a contact dissociated from an engagement and the HubSpot Webhook currently only supports the following subscriptions:

  • Contact creations
  • Contact deletions
  • Privacy compliant contact deletions - see below for more details
  • Contact property changes
  • Company creations
  • Company deletions
  • Company property changes
  • Deal creations
  • Deal deletions
  • Deal property changes

However, it is definitely possible to keep track of engagements associated with a contact. For this, your best bet is to use the Get recent engagements endpoint where you can keep track of engagements associated with a contact. If the engagement has associations to a CRM object, you would be able to get the object ID from the associations JSON found on the return response.

Hope this helps to shed some light!

3

Hi Wendy,
Thanks you for your reply, I perfectly understood the limitations of the webhooks.
However I am not sure that the recent modified engagements endpoint is working when you only remove or add a contact from an engagement:
Here’s the scenario:
1. On the hubspot portal, I create an engagement E on the company A, with associated contacts C1 and C2
2. I sync programmatically with my intern app this new engagement E.
3. From the portal, I dissociate the contact C1 from E.
4. Calling the recent modified engagements does not report this change

Today I have the feeling that each time I want to perform a sync of all engagements of a company with my internal app, I need to get an exhaustive list of all engagements of the company and check if I’m up to date with all of them (on association speaking). I’m afraid it will not be scalable with time.
Maybe I miss something but as you said, track only association changes is not possible so ?
Best regards,

etienne

4

Hey @etienne1,

Adding and removing object (e.g. contact/companies) association on an engagement does not create new engagement results. This means the Get recent engagements endpoint will pull recently created engagement, any association action (removed/add) would not trigger a new engagement json result.

For e.g. my engagement id 5404827645 is currently the first engagement pulled through when I call the Get recent engagements endpoint. Now within the association it is showing:

associations:{
contactIds:[22651 ],
companyIds:[ ],
dealIds:[ ],
ownerIds:[ ],
workflowIds:[ ],
ticketIds:[ ],
contentIds:[ ],
quoteIds:[ ]},

Assuming after one day, I have new engagements and I add another company association to engagment 5404827645, while it doesn’t create a new engagement result, if I search for engagement 5404827645, I’ll see the new associated companyId.

I do understand that this isn’t a great way of tracking add/remove associated on an engagement. Moving forward, I can honestly see a use case for this request and if you haven’t already, I’d recommend jumping over to the HubSpot Ideas Forum and posting this idea there so that it’s visible to the HubSpot product team and other HubSpot customers and developers. Hopefully this will gather more interest.

5

Hello Wendy,
Thanks for your detailed reply and sorry for the delay.
I have a full picture of what I can do now with the engagement API, I think it can fit my needs.

I will definitively take a look at Hubspot Ideas Hub.

Have a great day,

etienne bazin