Contact Properties

Contact properties are fields stored on a user's profile.

# Table of contents

# Data types for contact properties

Each field on a user profile has an associated data type: string, boolean, double, long, date, object, or array.

# Importing users

This section describes two ways to add fields to an Iterable user profile:

1. Uploading a CSV file

   You can import users with their contact properties if you have a CSV file with one column of emails and other columns of contact properties. Uploading a CSV with new values for existing contact properties will overwrite the existing contact properties.

   For more information, read Importing User Lists and CSV List Import Best Practices.

2. Using Iterable's API

   Calling the POST /users/update API and passing contact properties in the dataFields section will add or update the contact properties on a user's profile.

   For more information, read API Overview and Sample Payloads.

# Viewing a user's contact properties

Navigate to Audience > Contact Lookup to look up a user by email address.

# Inserting contact properties in messages

To insert contact properties into Iterable message templates, use double curly braces. For example, if a user profile has a firstName field, use the following syntax to insert that field:

{{firstName}}

{{[first name]}}

Templates can include data from contact properties, event properties, and data feeds.

For more information, read Personalizing Templates with Handlebars.

# Contact properties managed by Iterable

Iterable offers some built-in profile fields, detailed in Iterable-Specific User Profile Fields

Providing an ip (IP address) for a user causes Iterable to add city, country, state, and timeZone fields as well.

Setting the ip or timeZone field on a user profile also allows for messages to be sent at a specific local time. For more information, read Creating Blast Campaigns.

# How the commerce API affects user profiles

The POST /commerce/updateCart/ API is designed to be used whenever a user adds an item to a shopping cart. It adds the the shoppingCartItems to the user profile as a contact property. Each shoppingCartItem can contain other attributes such as price, quantity, sku, category, etc. These fields can all be used in Iterable message templates.

A call to POST /commerce/trackPurchase removes all the shoppingCartItems on a user's profile.