Scopes do not exist / recognized

Develop, Build & Integrate APIs & Integrations
1

Hello everyone,

I am trying to create a webhook that triggers everytime a call has been made, using the v4 API.

I have succesfully used the Hubspot CLI to create a project and add the webhook.

The problem is that when I try to add a subscription like this:

“subscriptions”: {

“crmObjects”: [

{

“subscriptionType”: “object.creation”,

“objectType”: “CALL”,

“active”: true

}

]

Then the deployment gives me this error:

" - This app does not have the required scopes to subscribe to `call.creation`. Please update your app scopes to include one of `crm.objects.calls.read, crm.schemas.calls.read` and try again."

If I add any of those, like this: (in app-hsmeta.json)

“requiredScopes”: [

“crm.objects.contacts.read”,

“crm.objects.contacts.write”,

“crm.schemas.calls.read”

]

Then I get the error:

Error: The scope crm.schemas.calls.read could not be recognized. Check your scope and try again.

Can anyone please explain the logic of this? Or how to create a (private) app that fires a message when a call has been made?

2

Hi @Schepler,

Looks like there might be some incorrect statements in the initial error message.

For call webhook subscriptions, use the current call-related scopes documented by HubSpot; scope requirements should be taken from the current scope reference rather than substituting contact scopes.

Calls are CRM activity records and should use the applicable call/activity scopes; they should not be treated as contact writes simply because a call can be associated with a contact.

So maybe try including scopes for “crm.objects.contacts.read, crm.schemas.contacts.read” instead.

Moderator Note: this post was reviewed for relevancy and optimized for clarity on September 29, 2026. Thank you for your contributions to the HubSpot Community!

3

Thanks for taking a look @evaldas :raising_hands: — Jaycee

4

Thanks a lot @evaldas - That did the trick!

5

Glad to hear, thank you for confirming!