Mapp Connect Basics
    • 3 Minutes to read
    • Dark

    Mapp Connect Basics

    • Dark

    Article summary

    This article covers basic information about Mapp Connect and its integration possibilities.


    Navigation Path

    Data Management > Mapp Connect

    What can I do in this window?

    • Create a new integration

    • View all your existing integrations and their statuses

    • Copy and Edit integrations

    Basic Mapp Connect Architecture


    Navigation path:

    Data Management > Mapp Connect > Add New Integration > Create

    Available Integrations:

    Overview tab

    This tab shows all basic information about the integration.

    Information & actions on the Overview tab



    Basic Information

    • Integration type: shows whether the integration is a generic one, or a 3rd-party one

    • Name: displays the name of the integration. You can edit the name anytime.

    • Description: this field is optional

    • Integration ID

    Automation (Whiteboard) settings

    • Trigger Whiteboard automations when user mapping attributes change - enable this if you use Whiteboards that react to any attribute changes. This attribute can be changed in the system via your Mapp Connect integration. 

    • Add incoming (external) event names - if you use the Mapp Connect External Event, here is where you define the events that will be included in the automation.

    Invalid Mappings

    Displays information whether all mappings within the integration are valid, and a warning if any mapping is invalid. In this case, the main page will display an error as well. Example:

    Add monitoring users

    Adds a Mapp Engage user who will receive notifications and logs related to the mapping. 

    Select the user email address from the drop-down list or perform a search, then click Add.


    Connected / Disconnected

    Disable / Enable

    Disables or enables the integration. 


    Creates a copy of the integration


    Removes the integration.


    Saves the basic settings of your integration.

    Mapping tab

    The Generic Integration only supports import for the destinations (subtypes) listed below.

    Each mapping contains a list of default destinations which are relevant to the mapping type. You can add user data mapping to every mapping type. For example, when you send an email you can add user attributes to user profile within the same API call.

    Location (mapping subtype)




    Allows you to map source data into a user profile using five attribute types: core, custom, member, and addon. 


    Allows you to send an email (prepared message) and optionally, map source data as an email parameter used in the prepared message template.


    Allows you to map source data with the default structure of the Transactional Related Data Table.


    Allows you to map source data with the default structure of the Wishlist Related Data Table.

    Abandoned Cart

    Allows you to map source data with the default structure of the Abandoned Cart Related Data Table.


    Allows you to map source location data with the default structure of location in the metadata service for the geofence functionality. For more information about the geofence functionality, see Location Management.


    Allows you to send an SMS (prepared message) to the contact using email or mobile number as an identifier.


    Allows you to send a push notification (prepared message) to the contact using email as an identifier. This requires adding the mobile app ID in the API call.

    Attribute Types

    Four types of attributes can be assigned to the profile.

    • Core or standard attributes like Email (always required), first name, etc. 

    • Custom attributes created by system users in one system. 

    • Member attributes. One attribute can vary for the same user depending on the group (optimal for agencies). 

    • Addon attributes. An attribute where a different value can be assigned to one profile depending of the integration. 

    Data Transformations

    During data import, you can transform the data into a unified format that you can define using the options listed below.

    Transformation Type


    To upper case

    Transforms source data to upper case.

    To lower case

    Transforms source data to lower case.

    Math floor

    Transforms numeric value to integer.


    Adjusts format of the timestamp to your supported format.

    Remove char

    Allows you to specify a character or string which will be removed from incoming data. 


    Lets you create a custom data transformation using JavaScript. A custom transformation cannot be saved until it is executed (tested) and returns a single string value.

    For more information see Edit Data Transformations.

    Data Import tab

    What can I do in this window?

    • Create automated imports that let you sync your contact data from external sources into your Mapp Engage system.

    • View all your configured imports and monitor import status

    Examples of imports:

    • Add contacts to Mapp Engage

    • Update contact attributes in Mapp Engage

    • Remove users from Mapp Engage

    • Send an email (prepared message) with parameters to contacts

    • Add data to your custom Related Data tables

    • Add data to predefined Related Data: Transactions, Wish List and Abandoned Cart

    See our detailed how-to article for more information.

    Import Configuration tab

    In this tab, you can configure the details of your imports. For details, see our how-to article.

    Related Topics

    Third-Party Integrations

    Was this article helpful?

    What's Next