MailerWave Connect
A complete WordPress plugin connecting your site to MailerWave — signup forms, list management, campaign analytics, and WooCommerce buyer sync.
What is MailerWave Connect?
MailerWave Connect bridges your WordPress website and your MailerWave email marketing account. Once connected, you can build subscription forms, manage lists, browse and tag subscribers, analyse campaign performance, and automatically add WooCommerce buyers to your email list — all from your WordPress dashboard.
Installing the Plugin
Log in to your WordPress admin panel.
Go to Plugins → Add New → Upload Plugin.
Click Choose File and select the mailerwave-connect.zip file.
Click Install Now, then Activate Plugin.
A MailerWave entry will appear in your WordPress sidebar.
Minimum Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- An active MailerWave account with API access enabled
- WooCommerce 5.0+ (optional — only required for buyer sync)
Getting Started — Settings
After activating, go to MailerWave → Settings. This is where you connect the plugin to your account.
Finding Your API Token
Log in at app.mailerwave.com and click your profile icon.
Go to My Profile → API & Authentication.
Copy the API Token shown on that page.
Connecting the Plugin
Paste your API Token into the API Token field.
Select a Default List — used when a shortcode has no explicit list specified.
Optionally enter a Thank-You Redirect URL.
Click Save Settings. A green notice confirms success.
The API Base URL is hidden by default. Click Advanced Settings to expand it. Only change this if you self-host MailerWave on a custom domain.
Default: https://app.mailerwave.com/api/v1
Lists
The Lists tab shows all your MailerWave lists and their statistics, cached for one hour. Click Refresh Lists to fetch fresh data.
| Column | What it shows |
|---|---|
| Subscribers | Total active subscribers on the list |
| Open Rate | Percentage who opened at least one campaign |
| Click Rate | Percentage who clicked at least one link |
| Sub Rate | Rate at which new subscribers are joining |
| Unsub Rate | Rate at which subscribers are leaving |
| Unconfirmed | Signed up but not yet confirmed (double opt-in) |
| From | Default sender name and email address for this list |
Subscriber Tools
Find by Email
Enter any email address to look up a subscriber across all your lists. The result card shows all their details and lets you add or remove tags using a comma-separated list.
Tags label subscribers for segmentation inside MailerWave. Example: vip-customer, webinar-attendee, woocommerce-buyer
Browse List Subscribers
Select a list to load its subscribers 25 at a time. Filter by open and click activity. Each row has two actions: Unsub (unsubscribes but keeps the record) and Delete (permanently removes — cannot be undone).
Add Test Subscriber
Manually add an email to any list — useful for testing your form and welcome sequence before going live.
Signup Forms
Creating a Form
Go to MailerWave → Signup Forms.
Optionally click a template card to pre-fill the fields.
Click Create New Form and fill in: Form Name, Title, Description, Success Message, Button Text.
Choose optional fields: First Name, Last Name, Phone Number.
Select the MailerWave list and click Create Form.
Fields always display in this order: First Name (if enabled) → Last Name (if enabled) → Email (always) → Phone (if enabled).
Embedding with a Shortcode
Copy the shortcode from the forms table and paste it into any page or post:
Replace 1 with the form ID. Multiple forms on the same page work independently.
Form Templates
Click any template card at the top of the Signup Forms tab to instantly pre-fill all form fields. Edit any field before saving.
| Template | Best used for |
|---|---|
| Newsletter Signup | Regular newsletter or content subscription |
| Free Resource / Lead Magnet | Offering a free guide, checklist, or download |
| Webinar Registration | Registering attendees for a live event |
| Early Access / Waitlist | Building anticipation before a product launch |
| Discount / Coupon Offer | Growing your list with a discount incentive |
| Course / Challenge Signup | Enrolling people into an email course |
| Contact / Callback Request | Capturing leads who want a call-back |
| Community Signup | Inviting visitors to join a members community |
Campaign Analytics
The Analytics tab lists all your campaigns. Click Load on any row to fetch live metrics. Click a campaign name to open the detail drawer showing top locations, top openers, and tracked links.
The MailerWave API is read-only for campaigns. To create, edit, or send a campaign, use the Open Dashboard button to log in to MailerWave directly.
WooCommerce Integration
When WooCommerce is active, a WooCommerce section appears in Settings. Buyers are automatically added to a MailerWave list when their order reaches Completed status.
Setup
Go to MailerWave → Settings and scroll to WooCommerce Integration.
Tick Enable and select a Buyers List.
Choose your opt-in mode and click Save Settings.
Opt-In Modes
Every buyer synced via WooCommerce is automatically tagged woocommerce-buyer so you can target them with specific campaigns or automations in MailerWave.
Shortcode Reference
Specific form by ID
[mailerwave_form id="1"]
Default form (no ID)
[mailerwave_form]
Uses the Default List from Settings. No saved form configuration is applied.
Custom list override
[mailerwave_form list_uid="your-list-uid-here"]
Subscribes to the specified list UID. Get list UIDs from the Lists tab.
Troubleshooting
- Ensure your account has the Administrator role (manage_options capability).
- Some security plugins block option saves — try deactivating them temporarily.
- Verify your API token — copy it fresh from your MailerWave account.
- Ensure your server can make outbound HTTPS requests.
- Check
wp-content/debug.logfor entries starting with “Mailerwave API error”.
- Confirm the shortcode ID matches a form in the Signup Forms table.
- Ensure the form has a list selected.
- Clear all caching plugins after installing or updating.
- Confirm WooCommerce Integration is enabled and a Buyers List is selected.
- The sync only fires on Completed status — not Pending or Processing.
- If using opt-in mode, confirm the checkbox was ticked at checkout.
- Check
wp-content/debug.logfor “Mailerwave WooCommerce:” entries.
- The phone field requires the intlTelInput library from cdnjs.cloudflare.com.
- If your site has a Content Security Policy, whitelist cdnjs.cloudflare.com.
Frequently Asked Questions
Can I use multiple forms on the same page?
Yes. Each form instance is fully independent with its own security nonce and state.
Can I create campaigns from the plugin?
No. The MailerWave API is read-only for campaigns. Use the Open Dashboard button to log in and create campaigns directly in MailerWave.
Will it work if I self-host MailerWave?
Yes. Click Advanced Settings in the Settings tab and update the API Base URL to your installation, e.g. https://mail.yourdomain.com/api/v1
What happens if an email is already subscribed?
The form shows “This email is already subscribed.” No duplicate is created. This applies to both the front-end form and the WooCommerce sync.
Is subscriber data stored in WordPress?
No. All subscriber data lives in your MailerWave account. The plugin communicates with the API in real time and stores nothing in the WordPress database.
How do I update the plugin?
Deactivate and delete the existing version, then install the new zip. Your settings and saved forms are stored in the database and will not be affected.
MailerWave Connect v2.3.0 · mailerwave.com