# API Calls Scope for Call Details

**URL:** <https://community.hubspot.com/t/api-calls-scope-for-call-details/143765>\
**Category:** APIs & Integrations\
**Tags:** contacts\
**Created:** [December 7, 2025, 11:30am UTC](https://community.hubspot.com/t/api-calls-scope-for-call-details/143765 "2025-12-07T11:30:12Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![helpmepls](https://avatars.discourse-cdn.com/v4/letter/h/5f9b8f/32.png) [@helpmepls](https://community.hubspot.com/u/helpmepls)\
**Post date:** [December 7, 2025, 11:30am UTC](https://community.hubspot.com/t/api-calls-scope-for-call-details/143765/1 "2025-12-07T11:30:12Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [December 8, 2025, 1:04pm UTC](https://community.hubspot.com/t/api-calls-scope-for-call-details/143765/2 "2025-12-08T13:04:47Z")

</div>

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](https://developers.hubspot.com/docs/api-reference/crm-calls-v3/guide)  
- [Engagements | Meetings](https://developers.hubspot.com/docs/api-reference/crm-meetings-v3/guide)  
- [Manage OAuth access tokens](https://developers.hubspot.com/docs/api-reference/auth-oauth-v1/guide)  
Now, let’s put you in touch with our Top Experts: Hi @Anton, [@sylvain\_tirreau](https://community.hubspot.com/t5/user/viewprofilepage/user-id/601366) and @Christensen do you have suggestions to help @helpmepls, please?

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

---

<div class="post-metadata">

**Author:** ![RubenBurdin](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/rubenburdin/32/75212_2.png) [@RubenBurdin](https://community.hubspot.com/u/RubenBurdin)\
**Post date:** [December 15, 2025, 6:20pm UTC](https://community.hubspot.com/t/api-calls-scope-for-call-details/143765/3 "2025-12-15T18:20:48Z")

</div>

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 ([Understanding the CRM APIs - HubSpot docs](https://developers.hubspot.com/docs/guides/crm/understanding-the-crm) )

Hope this helps you get unstuck.