Articles in this section

See more

Letterhead + Iterable Integration

The Letterhead + Iterable integration lets you build newsletters in Letterhead and easily send them in Iterable campaigns—without having to migrate any audience data or maintain your own sending infrastructure.

# In this article

# Setup instructions

To connect your Iterable and Letterhead accounts, follow these steps:

# 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 Letterhead

# Select Iterable as your preferred sender

  1. Sign in to your Letterhead account.

  2. Go to Settings > Newsletters.

  3. For the sender, select Iterable.

  4. Enter the following credentials for your Iterable project:

    • API Key: The API key you created in Iterable in the previous step.

    • API Region: The location of the Iterable data center (US or EU) that hosts your Iterable project.

    • Unsubscribe Tag: Which of Iterable's built-in merge tags you want to use to insert an unsubscribe link into your newsletter (required for all emails sent via Iterable): {{hostedUnsubscribeUrl}}, {{unsubscribeMessageTypeUrl}}, or {{unsubscribeUrl}}. To learn more about which of these merge tags you should use for your team's email marketing strategy, see Include Email Unsubscribe Links.

    • Reply Address: The Default Reply-To email address for one of your project's verified email senders. This value becomes both fromEmail and replyToEmail in the Iterable template payload.

    • Sender Name: The From Email address for one of your project's verified email senders. This value becomes fromName in the template payload.

    • Message Type ID (optional): The ID for the message type (found on the Message Channels and Types page) that you want to associate with your newsletters. This is added to the template's payload only if the field is set and numeric. When messageTypeId is included in the template payload, Iterable associates every campaign using that template with that message type.

    NOTE

    Newsletter campaigns delivered with this integration should be sent from a marketing channel. Using the transactional message type for newsletters would violate CAN-SPAM and GDPR compliance rules.

  5. Click Save.

Configuring the integration

# Building and sending newsletters with the integration

Once you've completed the setup instructions above, the Letterhead connection is active. You can continue building newsletters in the Letterhead editor as usual, and Letterhead will use Iterable as the default sender instead of Letterhead's native sending tools or another third-party ESP. To learn more about building newsletters in Letterhead, see Letterhead's Newsletters support documentation.

# Creating a newsletter

When you create a newsletter in Letterhead using this integration, Letterhead makes a call to Iterable's Create Template API endpoint, which generates an associated template for the newsletter in Iterable. You can continue building and editing your newsletter content in Letterhead.

# Previewing a newsletter

When you preview a newsletter template in Letterhead, Letterhead calls Iterable's Create Template API endpoint, followed by the Preview Email Template endpoint, which generates a rendered HTML preview of your newsletter content in Letterhead.

# Sending newsletter proofs

When you send a test version of a newsletter, Letterhead calls the Send Email Template Proof endpoint, which sends a proof of the rendered email campaign to the specified email address.

# Sending a newsletter campaign

When you schedule a newsletter campaign in Letterhead, Letterhead calls Iterable's Create Template API endpoint one more time to finalize any template changes, then calls the Create Campaign API endpoint. This generates an associated Iterable blast campaign, and Iterable sends the campaign at the time specified in the sendAt field of the API call.

To learn more about sending or scheduling campaigns in Iterable, see Sending or Scheduling a Blast Campaign.

# Monitoring campaign engagement

Letterhead displays a basic set of performance metrics that give you a quick snapshot of campaign performance:

  • Sent
  • Opens (total & unique)
  • Clicks (total & unique)
  • Unsubscribes
  • Bounces
  • Spam complaints (total)

However, when using Iterable to send your Letterhead newsletter campaigns, Iterable becomes the source of truth for email performance data. Use Iterable's engagement monitoring tools for in-depth analysis and official performance reporting.

# Learn more

To learn more about this integration, see Letterhead’s support documentation. For additional questions or if you need help setting up this integration, reach out to your Iterable customer success manager.

Related articles