topic API Calls Scope for Call Details in APIs & Integrations

API Calls Scope for Call Details

helpmepls — Sun, 07 Dec 2025 11:30:12 GMT

I am new, and trying to get logged calls and the internal data of the call
(type, description, owner, date/time etc)
I can not find the scopes required for Calls (and meetings) that the breeze AI describes i need for the API call to get this data.

Please point me towards the correct scope. Thank you.

Re: API Calls Scope for Call Details

BérangèreL — Mon, 08 Dec 2025 13:04:47 GMT

Hey @helpmepls 👋 and welcome, it's a pleasure to have you here!

Thanks for reaching out to the HubSpot Community!

Here are some resources that might help you:

- Engagements | Calls
- Engagements | Meetings
- Manage OAuth access tokens

Now, let's put you in touch with our Top Experts: Hi @Anton, @sylvain_tirreau and @Christensen do you have suggestions to help @helpmepls, please?

Thanks so much and have a lovely day!
Bérangère

Re: API Calls Scope for Call Details

RubenBurdin — Mon, 15 Dec 2025 18:20:48 GMT

Hi @helpmepls , welcome to the Community. This is a very common point of confusion, so you’re asking the right question.

Calls and meetings are not controlled by a special “calls” or “meetings” scope. They live under Engagements, and more recently under the CRM Objects API, which is why Breeze AI or older docs can feel misleading.

To read logged calls and meetings with details like type, body/notes, owner, and timestamps, you need these scopes:

crm.objects.calls.read
crm.objects.meetings.read

If you also need to create or update them, add: (crm.objects.calls.write, crm.objects.meetings.write)

Those scopes apply whether the call was logged manually, via a calling provider, or through workflows. You’ll typically retrieve the data via the CRM objects endpoints, for example:

/crm/v3/objects/calls
/crm/v3/objects/meetings

If you’re working with legacy Engagements endpoints, the broader scope crm.objects.engagements.read used to be enough, but HubSpot is clearly moving toward object-specific scopes, so I’d recommend using the calls/meetings object scopes directly going forward.

One more thing to watch out for: some internal call metadata (like recordings or provider-specific fields) may require additional permissions or may not be exposed at all via API, depending on the calling integration used.

This page is the most reliable reference for current CRM object scopes (https://developers.hubspot.com/docs/guides/crm/understanding-the-crm )

Hope this helps you get unstuck.