During installation, HubSpot will display a permission approval screen asking you to grant the integration access to your HubSpot account. You must approve these permissions for the integration to work correctly.

What you will see


After entering your Portal ID and selecting your HubSpot account, HubSpot will show a screen listing the permissions being requested. Click Grant Access to continue.

Permissions requested and why


PermissionPurpose
oauthAuthenticate and connect your HubSpot account
formsAccess HubSpot forms associated with your portal
crm.objects.contacts.readRead existing contact records
crm.objects.contacts.writeCreate and update contacts from Magento customers
crm.schemas.contacts.readRead contact property definitions
crm.schemas.contacts.writeCreate custom contact properties
crm.objects.companies.readRead existing company records
crm.objects.companies.writeCreate and update company records
crm.objects.deals.readRead existing deal records
crm.objects.deals.writeCreate and update deals from Magento orders
crm.schemas.deals.readRead deal property definitions
crm.schemas.deals.writeCreate custom deal properties
crm.objects.owners.readRead HubSpot user/owner data for record assignment
crm.objects.line_items.readRead existing line item records
crm.objects.line_items.writeCreate line items and attach them to deals
crm.schemas.line_items.readRead line item property definitions
crm.objects.orders.writeCreate order records from Magento orders
crm.schemas.orders.writeCreate custom order properties
crm.pipelines.orders.writeManage order pipeline stages
crm.objects.carts.writeCreate abandoned cart records
crm.schemas.carts.writeCreate custom cart properties
e-commerceEnable the HubSpot eCommerce Bridge for syncing
integration-syncAllow background data sync between Magento and HubSpot

Optional permissions

PermissionPurpose
communication_preferences.readRead contact email subscription preferences
communication_preferences.writeUpdate email subscription preferences for synced contacts

Important

  • If you click Deny or close the screen, the integration will not be connected.
  • You must be a Super Admin in HubSpot to approve these permissions.
  • These permissions only allow the integration to read and write data related to your Magento store. No other data in your HubSpot account is accessed.