AFI AFI

MailWizz

Estimated reading: 2 minutes Updated August 1, 2026

MailWizz is a self-hosted email marketing application. Advanced Form Integration subscribes contacts to your MailWizz lists from WordPress form submissions.

What you’ll need

  • An active MailWizz account.
  • Your MailWizz API credentials (see below).
  • The Advanced Form Integration plugin installed and activated.

Get your MailWizz API credentials

  1. Sign in to your MailWizz installation.
  2. Go to Customer → API Keys and generate a new API key.
  3. Copy the API URL (your MailWizz base URL) and the API Key.
  4. In WordPress, go to AFI → Settings → MailWizz.
  5. Click Add Account, enter the API URL and API Key, and give the account a name.
  6. Click Save.

Create the integration

  1. Go to AFI → Add New.
  2. Give the integration a name, for example Form to MailWizz.
  3. Under Trigger, pick the form plugin and the specific form.
  4. Under Action → Platform, select MailWizz.
  5. In Task, choose Subscribe To List.
  6. Pick the saved account.
  7. Map your form fields onto the fields listed below.
  8. Optional: open Conditional Logic to limit which submissions are sent.
  9. Click Save Integration.

Screenshot: AFI field-mapping screen with MailWizz fields visible

Tasks supported

Subscribe To List

Subscribes a contact to the selected MailWizz list via the MailWizz REST API.

Field Field key Required Notes
Email email Yes
First Name fname No
Last Name lname No

Pro features

The Pro integration extends the free version with additional capabilities. Pro uses the same MailWizz connection.

Feature comparison

Feature Free Pro
Subscribe to list
Standard fields
Custom fields No

Conditional logic example

Only send data to MailWizz when specific conditions are met. For example, add a condition on a form field to control which submissions are forwarded.

Troubleshooting

Nothing arrives in MailWizz

Open AFI → Log and find the most recent entry. AFI stores the request URL, body, and raw response.

API credentials rejected

Verify your credentials in your MailWizz account settings. If they were regenerated, update them in AFI → Settings → MailWizz.

Related docs