AFI
MailPoet
MailPoet is an email marketing plugin for WordPress. AFI subscribes contacts to your MailPoet lists directly through the MailPoet PHP API, so no API key or external HTTP connection is needed. The plugin must be installed and activated on the same WordPress site.
What you’ll need
- The MailPoet plugin installed and activated on your WordPress site.
- At least one MailPoet mailing list created.
- The Advanced Form Integration plugin installed and activated.
Create the integration
- Go to AFI → Add New.
- Give the integration a name, for example
Newsletter Signup - MailPoet. - Under Trigger, pick your form plugin and the specific form.
- Under Action → Platform, select MailPoet.
- In Task, choose Subscribe To List.
- Select the target MailPoet list from the dropdown. Available lists are fetched automatically from your MailPoet installation.
- Map your form fields to the MailPoet subscriber fields (see below).
- Click Save Integration.
Tasks supported
Subscribe To List
Creates or updates a subscriber in MailPoet and adds them to the selected list. If a subscriber with the same email already exists, their profile is updated; otherwise a new subscriber is created. The subscriber is then added to the chosen list via the MailPoet PHP API (MailPoet\API\API::MP('v1')).
Subscriber fields
MailPoet subscriber fields are fetched dynamically from your MailPoet installation. The standard fields are:
| Field | Field key | Required | Notes |
|---|---|---|---|
email |
Yes | ||
| First Name | first_name |
No | |
| Last Name | last_name |
No |
Any additional custom subscriber fields you have defined in MailPoet will also appear automatically in the field mapping table.
Troubleshooting
Subscribers not appearing in MailPoet
- Go to AFI → Log and check the most recent entries for error messages.
- Verify that the MailPoet plugin is installed and activated on the same WordPress site.
- Confirm the selected list still exists in MailPoet.
- Make sure the Email field is mapped and the submitted value is a valid email address.
Subscriber created but not added to the list
This can happen if the MailPoet API returns an error during the subscribeToLists call. Check the AFI log for the specific error message. Double opt-in settings in MailPoet may also affect when subscribers appear as confirmed.