Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
CRM
crm.objects.companies.read
crm.objects.contacts.read
crm.objects.deals.read
tickets
e-commerce
This endpoint is used to get an engagement (a task or activity) for a CRM record in HubSpot.
Use case for this endpoint: This data can be used to report on per-rep productivity or to integrate HubSpot with other back-office tools.
For another example, you can use this information about an individual call to drive automation about when the next follow-up meeting or call should happen.
Scopes
In addition to the contacts scope, the sales-email-read scope is required in order to receive the details of any email-type engagements. See the Engagement API Overview for more details.