This topic gives you a quick overview of how to format an XML file to import contacts into Mapp Engage.

Hint:

This topic assumes that you have a strong familiarity with XML files, data import, and Mapp Engage attribute types. If you need more detailed information, see ​XML Format for Contact Imports​.


Standard Attributes​

The following elements are nested inside the user element.


XML Element

Detailed Information

Data Type

email

The email must be formatted as a standard email address (localpart@domain.com).

String

mobilenumber

The mobile number must include the area code. The plus sign (+) before the number can be included, but is not required. The mobile number must not include any extra zeroes.

String

faxnumber

This attribute, previously used to store the fax number, stores the mobile app alias. This field accepts numbers and letters as well as special characters, including periods and underscores. Mapp Engage does not validate the values in this field. The maximum character count per value is 2000 characters.

String

identifier

This attribute stores an external identifier (for example, from a CRM system). This field accepts numbers and letters as well as special characters, including periods and underscores. Mapp Engage does not validate the values in this field.

To import files that identify contacts with the external identifier, use a special import procedure. For instructions, see ​Update Contacts with External Identifier​.

String

firstname

This field stores the first name of the contact. There are no special formatting requirements. Mapp Engage does not validate the values in this field. The maximum character count per value is 2000 characters.

String

lastname

This field stores the last name of the contact. There are no special formatting requirements. Mapp Engage does not validate the values in this field. The maximum character count per value is 2000 characters.

String

nickname

This field stores the preferred name of the contact. There are no special formatting requirements. Mapp Engage does not validate the values in this field. The maximum character count per value is 2000 characters.

String

dateofbirth

For the date of birth, use the following format: 1965-08-08 or 1965-08-08T12:00:00+00:00

Date

title

These values store the preferred title as a number.

  • 1 = Mr.
  • 2 = Mrs.
  • -1 = unknown

Number

zipcode

The zip code or postal code format depends on the country. In Mapp Engage, this attribute is a string field that can accept both letters and numbers. Mapp Engage does not validate the values in this field. The maximum character count per value is 2000 characters.

String

partnerid

This field stores a number that identifies an external source of the contact addresses. This field is limited to a maximum of 5 numeric characters.

Number

isocountrycode

The values must conform to the standardized ISO 3166 format. For more information, see https://en.wikipedia.org/wiki/ISO_3166-1.

String

isolanguagecode

The values must conform to the standardized ISO 639 format. For more information, see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes.

String

timezone

The values must conform to the standardized tz database format, also known as IANA. (For example: America/New_York or Europe/Berlin) For more information, see https://en.wikipedia.org/wiki/Tz_database.

String

Hint:

Mapp Engage uses ISO-8601 date formats. Enter the time zones as follows: YYYY-MM-DDThh:mm:ss (+/-)GMT difference. For example, the time zone US/Eastern is formatted: 2012-12-25T15:15:15-05:00. ISO-8601 is recommended for formatting date information in the import file. Deprecated formats are not fully supported


Additional Information​

The following elements are nested inside the user element.

The maximum number of characters for each value is 2000.


Attribute or Setting

XML Element

XML Attributes

​Custom Attributes​

namedattr

name

​New Custom Attributes​

namedattr-definition

enum - true or false

type - string, number, date, or boolean

name

​Member Attributes​

memberattr

name

​Read Mode​

channel

See ​XML Format for Contact Imports​

​Message Limitation​

maxmessages

number - the maximum number of messages

period - the period, in days