Install the Omnisend for WordPress plugin to collect form submissions, segment contacts, and automate email campaigns directly from your WordPressΩ site.
Before You Begin
⚠️ Important: If you use WooCommerce, install the Omnisend for WooCommerce plugin instead. It includes all WordPress features plus abandoned cart recovery, order tracking, and product sync.
The Omnisend for WordPress plugin is designed for non-ecommerce sites. You can enhance it with WordPress add-ons for additional functionality.
Benefits
Before we move further, let's list all the benefits you get with the integration:
Signup Forms: Create popups, landing pages, and embedded forms to grow your contact list.
Automations: Set up Welcome, Birthday, and Browse Abandonment workflows.
Contact Segmentation: Target subscribers by behavior, location, or form responses.
Campaign Tools: Send email campaigns with A/B testing and Campaign Booster.
Reporting: Track form submissions, automation performance, and campaign results in one dashboard.
Add-On Support: Integrate with WordPress plugins to pass additional contact data.
Setup Process
You can connect WordPress to Omnisend in two ways – either through Omnisend or through WordPress.
Connecting through WordPress
Step 1. Install the WordPress app in Omnisend or generate an API key as described here.
⤵️
Step 2. Install and activate the Omnisend for WordPress plugin in your WP-admin.
Step 3. Go to the Omnisend tab, enter the API key, and click 'Connect to Omnisend'.
Step 4. You can now easily create, publish, and manage forms to collect subscribers, segment them, and send email campaigns.
Connecting through Omnisend
Step 1. In Omnisend's main dashboard, click the 'Connect your store' button.
Step 2. Select WordPress.
Step 3. In the next window, click on the 'Install Omnisend plugin' button. You'll then be redirected to WordPress' marketplace.
Step 4. Install and activate the Omnisend for WordPress plugin in your WP-admin.
Step 5. Copy the API key that's provided in Omnisend and paste it in WordPress and click on 'Connect to Omnisend' button.
⬇️
Step 6. In Omnisend, check API connection whether integration works correctly.
What Data Is Synced
The plugin automatically sends the following data to Omnisend:
Email address
First name
Last name
To pass additional fields (like phone number or custom properties), install a WordPress add-on. Browse available add-ons →
Troubleshooting
I'm connecting my WordPress site with your plugin, and when entering the API, I'm getting an error: "Unexpected token '<', "<!doctype "... is not valid JSON".
This error can occur due to your WordPress site's permalink settings. Try changing the permalink options. We suggest using the Plain option, but you can experiment with different options to see which one works.
To change your permalink settings, follow these steps:
Log in to your WordPress Dashboard.
Go to Settings → Permalinks.
Select an alternative permalink structure and click Save Changes. For example, if you are currently using the Day and name settings, change them to something else, like Plain or Post name.
If the issue persists, please provide our support team with a list of your installed plugins, as certain plugins may affect the connection process.
Connection fails after installation
Cause: Security, caching, or performance plugins often block the API connection.
Fix:
Temporarily deactivate the following plugins (if installed):
Wordfence
LiteSpeed Cache
Cloudflare
Akismet Anti-Spam
WP Armour
Perfmatters
Other caching plugins
Try connecting again.
Reactivate plugins one by one after connection succeeds.
I use Cloudflare and can't connect
Cloudflare's firewall may block Omnisend's API requests.
Fix:
In Cloudflare, go to Security → WAF → Create Rule.
Whitelist these Omnisend IP addresses:
34.170.162.11
34.56.62.59
34.56.108.215
34.133.59.36
34.58.66.146
35.184.130.5
35.232.14.89
Add 'Omnisend/1.0' (case-sensitive) to your user-agent whitelist.
Reinstall the Omnisend plugin in WordPress.
I see a white page or Apache error when clicking "Connect"
Your server may be stripping the Authorization header.
Fix:
Add this line to your
.htaccessfile:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
If the issue persists, contact your hosting provider to enable REST API access.
I uninstalled and reinstalled the plugin. How do I reconnect?
In your WordPress admin, find the Omnisend plugin.
Click Connect your account.
A popup will ask you to approve the connection – click Approve.
If WordPress shows "connected" but Omnisend shows "disconnected," contact support to manually disconnect the backend before reconnecting.
WordPress shows "connected" but Omnisend shows "Connect your store"
This indicates an incomplete backend connection.
Fix:
Deactivate and reactivate the Omnisend plugin in WordPress.
Try connecting again.
If the issue persists, contact support to manually disconnect the store on the Omnisend side so you can complete a fresh reconnection.
FAQ
Where do I find my API Key?
In Omnisend, go to Store Settings → API Keys → Create API Key. Copy it immediately after creation – you won't be able to view it again.
What's the difference between "Omnisend for WordPress" and "Omnisend for WooCommerce"?
If you use WooCommerce, install Omnisend for WooCommerce – it includes all WordPress features plus abandoned cart recovery, order tracking, and product sync.
If you're not using WooCommerce, use the standard Omnisend for WordPress plugin for email marketing and signup forms.
Can I use this plugin on a staging site?
Yes, but don't copy plugin files from staging to live. Reinstall the plugin on your live site and connect to the correct Omnisend account/store.
Which plugins typically block the connection?
Security, caching, and performance plugins often interfere. Common culprits: Wordfence, LiteSpeed Cache, Cloudflare, Akismet, WP Armour, and Perfmatters.
💬 Need help? Contact our support team via in-app chat or email [email protected] for 24/7 assistance.