Push Planet + Iterable Integration

The Push Planet + Iterable integration lets you create subscription preference centers that sync data to your Iterable project—no HTML or software development required. With this integration, you can give your email subscribers a convenient way to update their subscriptions and manage the content they receive from your brand.

You can host pages on pushplanet.com, on a custom domain, or a subdomain of your own site (for example, prefs.yoursite.com).

# In this article

# Setup instructions

To set up this integration, you'll link your Push Planet account to Iterable and create reusable connections you can attach to your preference center pages. If you need to send data to different lists from different preference center pages, you can create a separate connection for each situation.

# In Iterable

# Create an API key

To create an API key, go to Integrations > API Keys.

See Creating API Keys for detailed instructions on how to create, name, and store the API keys you need for authenticating with Iterable's partner platforms.

# In Push Planet

To connect your Iterable project to your Push Planet account, create a new Iterable connection.

1. Sign in to your Push Planet account, and click Integrations > New Integration.

2. Under Add New Integration, click the Integration dropdown, and select one of the available Iterable integration options:

   

3. Give the connection a friendly name, and click Create Integration.

4. On the Authenticate Your Iterable Account page, enter the API key you created in the previous step.

   IMPORTANT

   Do not expose or share this API key.

5. Select the user identifier your Iterable project uses: email, userId, or both (hybrid).

6. Select the location of the Iterable data center (US or EU) that hosts your Iterable project.

# Retrieved user profile fields

For security purposes, Push Planet automatically restricts the data fields that can be retrieved from Iterable user profiles to the minimum that are needed to identify users and the lists, message types, and channels that they are subscribed to. This includes:

• email
• userId
• emailListIds
• subscribedMessageTypeIds
• unsubscribedMessageTypeIds
• unsubscribedChannelIds

This restriction is enabled by default on all new Iterable connections set up in Push Planet. However, if necessary, you can customize your connection to include more fields.

# Customizing retrieved user profile fields

If your team needs to retrieve additional user profile fields for targeting and personalization, you can customize your Iterable connection in Push Planet. There are two options for doing this:

# Option 1: Configure additional profile fields to be included

If you only need to include a small number of additional fields, you can add them individually in the Include Profile Fields section.

In this example, the fields firstName, membershipStatus, and birthDate will be retrieved—in addition to the default retrieved profile fields.

# Option 2: Configure certain profile fields to be excluded

If you expect to use a wide variety of user profile fields for targeting and personalization, it may be easier to configure Push Planet to retrieve all available fields, and exclude the ones you don't need. To do this, enter [ALL_FIELDS] under Include Profile Fields, then for Exclude Profile Fields, enter the specific data fields you want to exclude.

In this example, all available fields except for billing_address, billing_city, billing_state, billing_zip, and birth_date will be retrieved for user profiles.

Now that your Iterable project is connected to Push Planet, you can create and configure your preference center page.

# Learn more

For help setting up or troubleshooting this integration, see Push Planet's support article Connecting Your Push Planet Account to Iterable or reach out to the Push Planet support team at support@digioh.com.