To use the HubSpot connector, the first step is to connect your HubSpot account to magnews.
This setup allows the two platforms to communicate and exchange data securely, enabling contact synchronization and the sharing of marketing information.
Once the connection is established, you can configure data import and data export between the two systems.
Connection methods
You can connect magnews to HubSpot in two ways, depending on the type of integration you need.
Private App (recommended option)
This is the simplest and fastest solution, where the connection is based on a token generated in HubSpot.
- Best for: single-account integrations
- Main advantage: quick setup
- Required: an Access Token generated in HubSpot
Public App
This is the standard method for more structured integrations, based on the OAuth2 protocol.
- Best for: multi-account or distributed scenarios
- Main advantage: centralized permission management
- Required: Client ID and Client Secret
Configuration in HubSpot
Before connecting magnews, you need to create an app in HubSpot and obtain the required credentials.
Create a Private App
- Go to Settings > Integrations > Private Apps
- Create a new Private app
- Configure the required scopes, for example:
crm.exportcrm.importcrm.objects.contacts.readcrm.objects.companies.readcrm.schemas.custom.readcommunication_preferences.read
- Save and copy the Access Token
Create a Public App
- Go to Settings > Integrations > Legacy Apps
- Create a new Public app
- Configure the Redirect URL:
https://be-mn1.mag-news.it/be/oauth/client - Set the same scopes defined above for the Private App
- Save Client ID and Client Secret
Connect HubSpot to magnews
Once you have the credentials, you can complete the connection directly in magnews.
- Go to the Connect section in magnews
- Select HubSpot and click Connect
- Choose the connection method:
- Access Token (Private App)
- OAuth2 (Public App)
- Enter the required credentials
At this point, magnews is connected to HubSpot.
Initial configuration
After connecting, you need to complete an initial setup:
- select the magnews database to work on
- click Update definitions to align fields between HubSpot and magnews
Next steps
Once the connection is complete, you can configure data synchronization:
In these sections, you can define in detail how to synchronize contacts, properties, and engagement data between the two systems.