A Mapsimise marketing Connector can be used to export records from a Mapsimise data source into a selected Dotdigital Addressbook. There are two elements that are required for this, the first is a Dotdigital API User and the second is the Mapsimise marketing Connector.
Creating a Dotdigital API user
Once created the Dotdigital API User account credentials will be used to authenticate the connection between Mapsimise and Dotdigital allowing the records to be exported.
To create a Dotdigital API user first login to Dotdigital and navigate to the “Access” section.
From the “Access” section open the “API users” tab and click the “New User” button.
The API user email address field will be prepopulated with a unique email address, enter a description to indicate the user’s function and then create a password.
Creating a Mapsimise marketing Connector
To create a Mapsimise marketing Connector login to Mapsimise and navigate to the “Billing” section from the main menu.
Select the “Plan” table from the “Billing” screen which will reveal the current Mapsimise Plan and any currently active add-on packages.
Select the “Explore Add-ons” and from the available add-ons select the “Details” button from the Dotdigital Mapsimise Connector.
Once the “Buy” button on the Dotdigital Connector is clicked it will open the configuration panel where it will require the Dotdigital API User credentials and when filled the “Test Connection” will be unlocked and clicking it will login to the Dotdigital API. Upon a successful login the “Confirm Purchase” button will be unlocked allowing the finalisation of the Connector purchase.
Exporting and mapping Mapsimise records
The displayed Mapsimise Layer records can be exported at any time and any filtering applied to the Layer will be retained.
Clicking the “Export” button located on the grid will open the available export options. 
Clicking the Dotdigital “Add to Addressbook” button will open the field mappings between he Mapsimise records and the Dotdigital Contact record.
In the export menu the first option is to select the destination of the export, either enter the name of a new Dotdigital Addressbook or select to export the records into an existing one. Once an export destination has been selected the relevant Mapsimise field can be chosen to be mapped to the Dotdigital Contact entity. The Email field mapping is always required.
To start the export, click the “Add to Addressbook” button.
Checking Dotdigital imports
The duration of the import to Dotdigital will depend on the number of records being exported from Mapsimise, however the current number of Contacts can be viewed in the “Email” section under the “Contacts” tab.
