Mapsly is a standalone software platform that exchanges data with your HubSpot via its API and automatically logs your HubSpot users into Mapsly using their HubSpot user credentials.
Follow the steps below to set up your Mapsly account with HubSpot. Please note that you need to be the HubSpot administrator to complete this guide. If you are not a HubSpot administrator, please refer to this article first.
1. Install the Mapsly app
Install the Mapsly app from the HubSpot marketplace by this link. When prompted on the screen, choose your HubSpot account and then click the Connect app button:
2. Follow the Mapsly sign-up wizard
Follow the instructions in the sign-up wizard article and return here for the final steps.
3. Connect your HubSpot
4. Finalize import
Proceed to the Data source mappings article to finalize import.
Implementation is included in your Mapsly subscription!
Your Mapsly subscription includes implementation services, so we're inviting you to book a web call with our engineer today to learn more about your use case and help you integrate Mapsly with your system. You may also ask us for help in chat any time, 24/7.
Known limitations of the HubSpot - Mapsly connector
Deal - Company association is not automatically updated in Mapsly
When a Deal record is assigned to another Company, HubSpot does not update the Deal's Last modified timestamp or provide any other notifications about this, so in Mapsly, the Deal will remain assigned to the "old" Company. To help Mapsly pick up the updated association, update the Deal record in any other way so its "last modified" time updates, and Mapsly will re-import the Deal record and update its association with the new Company.
Only standard fields sync to Mapsly in real-time; custom fields are imported on schedule.
Due to a limit on the total number of fields synced via HubSpot webhooks, by default, only standard fields of standard objects are synced from HubSpot to Mapsly in real time. Custom fields and custom objects are synced by schedule, with the highest frequency of once every 10 minutes.
Customers on the Mapsly Enterprise plan may request that specific custom fields be synced in real time. Don't hesitate to contact Mapsly customer support for more details.
More information
Linking your existing Mapsly account to your HubSpot organization
If you need to link your existing Mapsly account to this HubSpot organization, you can just follow this guide.
Adding more users to Mapsly
New HubSpot users are automatically added to your Mapsly account with restricted access when they log into Mapsly with their HubSpot credentials at app.mapsly.com; you don't need to add them manually. Learn more about users and Single Sign-On here.
Uninstalling Mapsly
To uninstall Mapsly from your HubSpot account, please follow the HubSpot Knowledge Base article. Uninstalling the Mapsly app does not affect your HubSpot account or data.
More useful articles
If you'd like to see only standard objects on the map, like contacts, the wizard's instructions are self-explanatory. In more complex scenarios, when you'd like to see other objects in Mapsly as well or use coordinates instead of an object's address, please refer to these articles:
how to properly configure an object's address field (required for Deals/Opportunities and custom objects);
how to use an object's coordinates stored in the CRM instead of its address in Mapsly (how to skip geocoding for locations that cannot be described by an address or those for which you already have GPS coordinates in your CRM);


