[Quickbase] Mapsly setup guide

A step-by-step guide for setting up your Mapsly account with Quickbase

Erik avatar
Written by Erik
Updated over a week ago

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 'Assign token to apps' and 'Name' 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

  1. Open the table settings of the table for which you are planning to sync deleted records:

  2. Click on the '+ New' button at Webhooks:

  3. Click on '+ New Webhook' button:

  4. Configure the webhook. You need to select - when your table is deleted. The endpoint URL should have the following format:
    https://api.mapsly.com/v1/deleterecord?apikey=your_Mapsly_api_key&entity=%dbid%&id=[Record ID#]
    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:

  1. Inside Quickbase. If you prefer this way, install Mapsly to your Quickbase app.

  2. Or, in a separate tab, go to app.mapsly.com and enter your Mapsly login and password into the Mapsly login form.

More information

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, adding users to Mapsly who are not registered in Quickbase is possible.

More useful articles

If you'd like to see only standard objects like contacts on the map, 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:

Did this answer your question?