topic Re: Get engagements for a company deprecated endpoint in APIs & Integrations

Get engagements for a company deprecated endpoint

etienne1 — Fri, 03 Apr 2020 10:48:41 GMT

Hello,

I'm trying to find a simple solution to get the list (batch) of engagements (CALL, EMAIL...) for a given company of my Hubspot account. I want to get all information of engagements (content of the email, the contacts ids associated, date of creation...).
This endpoint perfectly fits my needs but Hubspot marks it as deprecated. We are redirected through the association endpoint but I didn't manage to get the same result as with the deprecated endpoint (1 http call to get all activities with their data scope to 1 company).

Indeed, I tried something like this:
https://api.hubapi.com/crm-associations/v1/associations/<company_id>/HUBSPOT_DEFINED/7

But I just get the list of engagements ids and I would need to loop on each of one to get all data of each engagement (performing N separate http call for N engagements).

Do I have a way to reproduce easely the depreacted endpoint behavior?

Stay safe

etienne

Re: Get engagements for a company deprecated endpoint

WendyGoh — Mon, 06 Apr 2020 04:10:40 GMT

Hey @etienne1,

Connor addressed a similar query, check this thread out: HubSpot Community - New way to get detailed list of engagements per contact.

Currently, there isn't an endpoint that behavior like the deprecated endpoint. That said, thank you for sharing your use case and we will aggregate the feedback here and bring it to the product team. Appreciate it.

Re: Get engagements for a company deprecated endpoint

etienne1 — Mon, 06 Apr 2020 08:51:54 GMT

Hey @WendyGoh ,

I thank you for your reply, I'll check the link you provided.
In the meantime, is it safe to use this deprecated endpoint in the midterm?

Best regards,

etienne

Re: Get engagements for a company deprecated endpoint

WendyGoh — Tue, 07 Apr 2020 02:41:15 GMT

Hey @etienne1,

While you can continue using the Get Associated Engagements, I'd suggest two things here:

1. Keep a look out for an X-HubSpot-API-Deprecated header in the response. If you detect this header in a response, please check this documentation to determine when it'll get sunset: Deprecated APIs.

2. Start using the CRM Associations API.

Re: Get engagements for a company deprecated endpoint

etienne1 — Tue, 07 Apr 2020 12:22:32 GMT

Hello @WendyGoh ,

1.I just curled the Get Associated Engagements endpoint and I don't see the `X-HubSpot-API-Deprecated` header for the moment. I will add a watcher though to be warned the day it appears.

2. I'd like to use this API but if I understood well I would use this endpoint: `https://api.hubapi.com/crm-associations/v1/associations/<company_id>/HUBSPOT_DEFINED/7` which only returns the engagements ids of a company, and I would need to loop on each id of the response to get content of each engagement. From 1 HTTP call (Get Associated Engagements API) I go to N+1 HTTP calls (1 for association and N for number of engagements) which is less efficient. Maybe I miss something ?

Best regards,

etienne

Re: Get engagements for a company deprecated endpoint

WendyGoh — Tue, 12 May 2020 01:25:55 GMT

Hey @etienne1,

Spot on. The Get associations for a CRM object will only return back the objectID. If you'd like to gather more details of each object, you'd need to use the respective object endpoint (i.e. CRM API | Contacts) to retrieve the object with properties.

Re: Get engagements for a company deprecated endpoint

avlambertucci — Mon, 22 Mar 2021 14:01:27 GMT

Hi @WendyGoh thanks for replying all these questions but can you please clarify @etienne1 last question about iterating through a list of engagements ID? because Its also exact pain point, eg: if a contact has 400 engagements we still would have to iterate through its ID's and only then, gather the data separately consuming several GET requests? instead of using the deprecated endpoint when used to return the 'explicid' data and not only IDS.

Thanks!

Re: Get engagements for a company deprecated endpoint

Polou — Tue, 18 May 2021 15:09:14 GMT

Hello @WendyGoh
i'd love to get the reply also. Indeed like @avlambertucci said, if an object has lots of engagements, we will need to make x api calls to get content of each engagements or even their type...

Thank you !