Quick Reference: Contact Import XML

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

​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