Skip to main content

How to Set Up the Iterable Integration and Sync

Connect Knak to Iterable to sync email templates directly from Knak to your Iterable account.

Before You Begin

You need:

  • Admin access in Knak

  • Access to create API keys in Iterable

  • A configured sender profile in Iterable

Create an API Key in Iterable

You must create an API key in Iterable before connecting the integration.

Step 1: Open API Keys

  1. Log in to Iterable.

  2. Hover over Integrations in the left navigation.

  3. Click API Keys.

    Iterable navigation menu showing Integrations > API Keys.

Step 2: Create a New API Key

  1. Click New API Key.

    +New API Key button highlighted.

  2. Enter a name for the key.

    • Example: Knak Integration

  3. Select Server-side as the key type.

  4. Click Create API Key.

    New API Key modal with the name field and Server-side option highlighted.

Step 3: Save the API Key

After the key is created:

  1. Copy the API key value.

  2. Store it in a secure location.

Copy your new API key window.

Important: You can only view the API key once. Save it before closing the window. If you lose it, you'll have to create a new one.

Connect Iterable in Knak

Step 1: Open Platform Integrations

  1. Log in to Knak.

  2. Go to Admin.

  3. Select Integrations.

  4. Click Platforms.

Platforms page on the admin side of the platform.

Step 2: Connect Iterable

  1. Locate the Iterable integration tile.

  2. Click Connect.

    Connect button on the Iterable Tile.

  3. Enter a name for the integration.

  4. Paste the API key from Iterable.

  5. Select the appropriate Data Center.

    • The Data Center setting selects the Iterable data center based on your login URL.

    • If you leave this field blank, Knak uses the US data center by default.

    • If you sign in to Iterable at https://app.eu.iterable.com, select EU.

    • If you sign in at https://app.iterable.com, use US.

    Data center selection dropdown.

  6. Click Create New Integration.

    Iterable settings configured in Knak with Create New Integration button visible.

Configure Sender Details

Your sender details in Knak must match the sender presets configured in Iterable.

View Sender Details in Iterable

  1. Click the Settings gear icon in the bottom left corner.

  2. Then hover over Current Projects and select Senders.

    Navigate to the Iterable Senders page.

View Sender Presets in Knak

  1. Go to Admin.

  2. Select Brands.

  3. Open the brand you want to edit.

  4. Scroll to Email Settings.

  5. Create, edit, or review sender presets.

    Email settings in Knak at the brand level.

Sync Templates to Iterable

Once the integration is connected, you can sync templates directly from Knak to Iterable.

Sync Requirements

Before syncing:

  • Verify sender details match between Knak and Iterable.

  • Confirm all required email settings are configured.

  • Ensure required compliance links are included.

Syncing Multiple Locales

You can sync templates that contain multiple locale variations.

Sync Walkthrough

Syncing Multiple Locales update 👇

Manage Your Integration

After setup, you can manage your integration from the Integrations page.

Add a New Connection

  1. Go to Admin > Integrations > Platforms.

  2. Scroll to All Platforms.

    Existing platform connections page.

  3. Locate Iterable.

  4. Click Connect or Add Another Connection.

Troubleshooting

BadParams Error When Syncing Without an Unsubscribe Link

If you sync an email without an unsubscribe link, Iterable may return a BadParams error.

This happens because Iterable requires every Marketing message to include an unsubscribe link. Iterable validates this requirement during the sync request.

Resolution

If your email does not include an unsubscribe link:

  1. Change the message type to Transactional.

  2. Sync the email again.

Transactional messages do not require an unsubscribe link.

Message type field selection in sync modal with Transactional message selected.

If you continue to receive a BadParams error after following these steps, your Knak account may require an additional setting to be enabled for your account. Contact Knak Support for assistance.

Note: Use Transactional only for transactional emails, such as password resets, receipts, or account notifications. Marketing emails should continue to use the Marketing message type and include the required unsubscribe link.

Blank Template Created After Failed Sync

If a sync fails, Iterable may create a blank template in the root template directory.

This behavior is part of the current integration design.

Recommended Action

  1. Locate the blank template in Iterable.

  2. Delete the template manually.

This helps keep your template library organized.

Templates page with 3 dot menu expanded and delete template option highlighted.

Dark Mode Button Display Issue

You may notice button text appears incorrectly when emails are sent from Iterable in dark mode.

This is not caused by Knak. The issue occurs because Iterable minifies the HTML during send.

Recommended Action

Contact the Iterable support team for assistance with dark mode rendering behavior.

Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.

Related Articles
Did this answer your question?