Mapsly is a standalone software platform that exchanges data with your Quickbase app through its API. Follow the steps below to set up your Mapsly account with Quickbase.
Signing up for a Mapsly account and connecting your Quickbase app
To create your Mapsly account and connect it to your Quickbase app, following this Mapsly sign-up wizard.
Once you complete the sign up wizard:
Go to Setup in the Mapsly main menu:
Click the + button, select Quickbase and follow instructions on the screen:
You'll be prompted to enter your Client token, AppId as well as your hostname without "https://" (like mapsly.quickbase.com).
If you are not sure how to get those parameters, then simply follow the instructions below:
To create a Client token go to My preferences:
Click on 'Manage my user tokens...':
Then click on 'New user token':
Fill in the fields and click 'Save'. Then, copy the newly created token to the Client token field inside Mapsly:
To find the AppId and your hostname simply go to your application's page and check the URL of that page. You will see that your URL consists of something like
https://mapsly.quickbase.com/db/brkdgmert, where mapsly.quickbase.com is your hostname and brkdgmert is your AppId.
Configuring webhooks with Mapsly API to sync deleted records
In order to be able to sync records that were deleted in your Quickbase app to Mapsly you need to create and configure webhooks. To create a webhook, do the following:
Generate API Key for your data source
First, generate the API key as described in this guide.
Create a webhook in Quickbase
Open the table settings of the table for which you are planning to sync deleted records:
Click on the '+ New' button at Webhooks:
Click on '+ New Webhook' button:
Configure the webhook. You need to select - when your table is deleted. The endpoint URL should have the following format:
where you need to replace your_Mapsly_api_key with your inbound API key. Finally, the HTTP method needs to be set to 'GET':
How to open Mapsly
There are two ways to open and then use Mapsly:
Inside Quickbase. If you prefer this way, install Mapsly to your Quickbase app.
Or in a separate tab go to app.mapsly.com and enter your Mapsly login and password into the Mapsly login form.
Adding more users to Mapsly
Please note that you will need to add to Mapsly only those users who will actually be using Mapsly (not all Quickbase users). Also, it is possible to add users to Mapsly who are not registered in Quickbase.
More useful articles
If you'd like to see on the map only standard objects 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 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);