Iterable

This guide will walk you through connecting your Iterable account to Composa, enabling you to export email templates directly to Iterable.

Prerequisites

Before connecting, you'll need:

• An Iterable account with administrator access

• Your Iterable Server-side API Key (with email template permissions)

• Your Iterable data center location

Connecting Iterable

Step 1: Identify Your Data Center

Iterable operates in multiple data centers. Your data center is typically indicated in your Iterable dashboard URL or account settings. Common options include:

• US (United States)

• EU (Europe)

If you're unsure, check your Iterable account settings or contact Iterable support.

Step 2: Get Your Server-side API Key

1. Log in to your Iterable dashboard

2. Navigate to Settings > API Keys

3. Create a new Server-side API Key or use an existing one

4. Ensure the key has permissions for Email Template management

5. Copy the API Key value

Important: Use a Server-side API Key, not a Mobile API Key. Only Server-side keys have the necessary permissions for template management.

Step 3: Connect in Composa

1. In Composa, go to Settings > Integrations

2. Find Iterable and click Connect

3. Select your Iterable data center from the dropdown

4. Paste your Iterable Server-side API Key in the provided field

5. Click Save

Composa will validate your credentials. Once validation is complete, your Iterable integration is active.

Exporting Templates to Iterable

Once connected, exporting a template to Iterable is simple:

1. Open a template in the Composa editor

2. Click the Export button in the toolbar

3. Select Export to Iterable

4. Your template is created as a new email template in your Iterable account

5. You can now use this template in your Iterable campaigns

Template Details

When you export a template to Iterable:

• The template name matches the template name in Composa

• The template includes all HTML, styling, and content from your Composa template

• The template is created in a draft state, allowing you to review it before use

• Any images or assets are included based on Composa's export settings

Disconnecting Iterable

To remove the Iterable integration:

1. Go to Settings > Integrations

2. Find Iterable in the list

3. Click Disconnect

Your Iterable account and any previously exported templates remain unchanged. You can reconnect at any time.

Troubleshooting

"Invalid API Key" Error

• Verify that you're using a Server-side API Key, not a Mobile API Key

• Confirm that the key has email template permissions enabled

• Check that the API key is active and hasn't been revoked in Iterable

"Data Center Not Found" Error

• Double-check that your selected data center matches your Iterable account's actual location

• If you're unsure, check your Iterable dashboard settings

Export Fails

• Verify that your Iterable integration is still active in Settings > Integrations

• Check that your API Key still has the necessary permissions

• Try disconnecting and reconnecting your Iterable account

• Ensure your Iterable account has space for new templates

Need Help?

For additional support:

• Consult Iterable's API documentation

• Contact Iterable support for account-specific issues

• Reach out to the Composa team for integration questions