Migrating to the new Flexmail version: Your complete guide

Why upgrade to the new version?

If you've landed on this article, it means you're part of the last 5% of Flexmail users who haven't yet switched to the latest version of Flexmail. This also means:

• You've been unable to use the latest Flexmail features and improvements for 2 years already
• You still can't use the new Email Builder, while the current Builder will be discontinued on January 30th

Your account will be automatically migrated to our latest version on December 15, 2025. This upgrade brings numerous improvements that will take your email marketing to the next level.

🚀 Key benefits of the new version:

Ease of use & Interface

• Intuitive new Email builder - Create beautiful emails without technical knowledge

AI-powered features

• AI suggestions for subject lines that boost your open rates
• Smart preheader optimization for better inbox presentation

Advanced targeting & segmentation

• Simplified segmentation - Select values from dropdown lists instead of manual typing
• Public and private interest groups with branded profile pages

Better integrations

• REST API (replacing the SOAP API which will be discontinued)
• Webhooks for real-time data synchronization

🔄 What exactly changes?

Segmentation becomes simpler

The new segmentation is more user-friendly and less error-prone:

Old situation:

• Manual value input (error-prone)
• Unclear functions and operators
• Complex nested structures possible
• No limit on conditions (slow)

New situation:

• Dropdown selections - no more typos
• Clear operators - intuitively understandable
• Maximum 5 conditions per segment - faster and clearer
• Better nesting - maximum 5 levels for optimal performance

Email builder upgrade

• Modern drag & drop interface replaces the old builder
• Template library with responsive designs
• Brand kit in settings for consistent branding

⚡ How to prepare for the migration?

Step 1: Inventory your current setup

• Review your segments - Which ones do you still actively use?
• Check integrations - Which API calls do you use?
• Backup important data - Export contact lists and reports

Step 2: Optimize for the transition

• Clean up conflicting segments (see yellow-marked segments in your account)
• Consolidate nested segments to maximum 5 levels
• Simplify complex segment logic
• Update your API integrations to REST API

Step 3: Plan your migration moment

• Choose a quiet period - Avoid busy campaign periods
• Communicate internally - Inform your team about the changes
• Test after migration - Plan time to try out new features

🛠 Specific migration actions per component

Adjusting segments

Resolving conflicts:

❌ Old syntax: "Contains" + manual input
✅ New syntax: "Equals" + dropdown selection

❌ Old: 10+ conditions with complex nesting
✅ New: Max 5 conditions per segment, use sub-segments

❌ Old: Mix of AND/OR operators in one segment
✅ New: One operator type per segment, distribute across multiple segments

Common problems & solutions:

Templates & emails

• On January 30, 2026, you must also be fully switched to the new Email Builder. More info can be found here.

Potential API migration

As a result of replacing old features, some old SOAP API services are also disappearing.

When we detect SOAP API usage in your account, we show a customized warning on your dashboard that explicitly mentions this.

If your integration with Flexmail currently uses these deprecated services, the existing integration will need to be adjusted or recreated to connect to our new Email Marketing API (REST).

Only in this way will the connection continue to work fully after switching your account.

Custom integrations

Is your contact data currently flowing automatically to Flexmail? Then you most likely have an integration that was specifically developed for you or is part of a partner's service offering.

In this case, it's best to contact your integration partner to review together what the next steps are to migrate to the new API.

Subscription forms

Don't have systematic synchronization but still see this message? Then you might be using a third-party plugin on your website for the subscription form that uses the SOAP API.

Replacing this plugin with a newer version or switching to an embedded opt-in form could be a simple solution in that case.

Contact your web developer to determine the best strategy.

API Documentation

• SOAP API: https://soap.flexmail.eu/documentation/
• Email Marketing API: https://api.flexmail.eu/documentation/

📈 After migration: Leveraging new possibilities

Right after the upgrade

1. Test the drag & drop builder - Create your first responsive template
2. Try AI suggestions - Let AI help you with subject lines
3. Configure interests - Better targeting than ever before

Within the first month

• Optimize your segmentation with the new possibilities
• Experiment with new template designs
• Set up webhooks for better data synchronization

Long-term benefits

• Higher engagement rates through better targeting
• Faster campaign creation thanks to improved workflow
• Better insights lead to data-driven decisions
• Future-proof platform with regular updates

🎯 Checklist for successful migration

Before migration:

Right after migration:

First week after migration:

📞 Need help with migration?

Our Customer Success team is ready to help you:

💡 Frequently asked questions

Will anything change about my subscription costs?

No, you pay the same amount for expanded functionality.

Will I lose my contacts?

No, all contact data remains preserved. Only certain segments may need to be recreated.

How long does the migration take?

The automatic migration goes quite quickly. You can get started immediately afterward.

Can I still go back to the old version?

Once switched, this is no longer possible. The old version will be completely discontinued on December 15th.

What if I miss the deadline?

Your account will be automatically migrated on December 15th. However, it's better to choose the moment yourself when it suits you.