MailerLite Plugin

Use the MailerLite Plugin to create and update MailerLite subscribers from new form results.

Add subscribers to your MailerLite account and optionally add them to one or more groups or collect opt-in preferences.

# Set Up the Plugin

Open the Plugins page for your form, select MailerLite, and enter your MailerLite API Key:

To get a MailerLite API Key, visit your MailerLite account and follow the steps below.

Note: If you’re using the Classic version of MailerLite, follow these instructions to find your API key.

Once logged in, open the Integrations tab:

Go to the API section and click Use:

Click Generate new token:

Enter a name for the token, such as Fun Forms Plugin, and click Create token:

Copy the generated token:

Return to the MailerLite Plugin in Fun Forms, paste the token into the input field, and click Connect:

Once connected, your MailerLite account name will be shown in the plugin settings.

# Create Subscribers with MailerLite

Use the Field Mapper within the MailerLite Plugin to connect your form fields to MailerLite field tags.

# Subscribe with Email

First, create a form and add an Email Field:

Use the Field Mapper to map the Email Field to the MailerLite field tag email:

Field type ‘Email’ • Field mapped to ’email’

Click Save and Publish, then enter an email address in your form and click Send:

When the form is submitted, a new MailerLite subscriber will be created using the email address:

That’s the basic setup. To include additional subscriber fields, groups, or opt-in preferences, read on.

# Add Subscriber Fields

MailerLite uses field tags to reference subscriber attributes such as First Name, Email, and Phone.

You can view the MailerLite field tags, including custom fields, or open Subscribers > Fields in the MailerLite app:

Always use the value shown in the Tag column, such as name or last_name.

Here are some commonly used MailerLite field tags:

• email - subscriber email (required)
• z_i_p - subscriber ZIP or postal code
• state - subscriber state or region
• phone - subscriber phone number
• name - subscriber first name
• last_name - subscriber last name
• country - subscriber country
• company - subscriber company name
• city - subscriber city

🔗 For more information about custom fields, see MailerLite’s Custom Fields Guide.

Add First Name and Company fields to your form, then map them to name and company:

Use the Field Mapper to connect each form field to its corresponding MailerLite field tag:

Click Save and Publish, then enter some data in your form and click Send:

The new subscriber will then include the additional Name and Company data in MailerLite:

# Add Subscribers to Groups

You can automatically add new MailerLite subscribers to one or more groups based on their form responses.

Open Subscribers, select Groups, and click Create group:

Enter a group name, such as Technology, and click Create:

Repeat the process to create additional groups, such as Arts and Science:

To let respondents choose a single group, use a Single-Select Field or Dropdown Field.

To let respondents choose multiple groups, use the Multi-Select Field.

Add the relevant field to your form, then add each MailerLite group name to the field’s Options:

Use the Field Mapper to tell the plugin that the field contains group names. Enter group_ followed by a unique suffix:

For example, group_interests tells the MailerLite Plugin that this field contains group names. The suffix doesn’t need to match a MailerLite group category, so you can use any value after group_, such as group_hobbies.

Click Save and Publish, then select one or more groups in your form and click Send:

The subscriber will then be added to the selected groups:

Open the subscriber in MailerLite to see the groups they belong to:

You can repeat this process with additional fields to add subscribers to multiple groups across your form.

# Automatically Add Subscribers to a Group

Want every subscriber to be added to the same group without asking them to choose? Use a Hidden Field:

Adding the Hidden Field to the form

Click Edit on the Hidden Field. Enter any unique value in Name, then enter the MailerLite group name in Value:

Use the Field Mapper to map the Hidden Field to a group using group_ followed by a unique suffix, such as group_arts:

Click Save and Publish. The Hidden Field won’t be visible to respondents. Submit the form with an email address:

The published form shown to respondents

The subscriber will be added to the Arts group:

Open the subscriber to see the group assigned to them:

# Collect Opt-In Permission

If you want to give respondents a choice about joining your MailerLite audience, you can use the Opt-In feature.

The respondent can choose whether they want to be added to your MailerLite audience. If they select the opt-in option, they’re added as a subscriber. If they don’t, the form result is still processed but no MailerLite subscriber is created.

The Yes/No Field is a simple option for collecting an opt-in choice:

Field type ‘Yes/No’ • Field mapped to ‘opt_in’

Important: The value Yes must remain unchanged for this to work. Don’t rename the Yes option in the field.

Use the Field Mapper to map the Yes/No Field to opt_in:

If the respondent selects Yes, they’re added to MailerLite. If they select No, the form result is still received, but no MailerLite subscriber is created.

You can also use the Consent Field as the Opt-In trigger. This is useful when you want to display additional information about your marketing or data-processing consent:

Field type ‘Consent’ • Field mapped to ‘opt_in’

Alternatively, you can use a Multi-Select Field if you want the opt-in field to be optional. When using this approach, the field must contain only one option:

Field type ‘Multi-Select’ • Field mapped to ‘opt_in’

Explainer: The Multi-Select Field must contain only one option when mapped to opt_in. The selected option is treated as the respondent’s Yes value.

That’s it! If you need any help, contact us anytime.