The Emma add-on needs to be installed and activated to see the features mentioned in this this documentation.

[Jump to top]

Setup Emma

Login to your Emma account. Choose Account Settings, then select the API Key tab, and Copy your Public API Key, Private API Key and Account ID.getting API Keys in Emma

Go to Ninja Forms > Settings then find Emma settings area and paste the Public API Key, Private API Key and Account ID into the fields provided.

Emma connection settings in WordPress

[Jump to top]

Adding an Emma action to your form

From the Emails & Actions tab of your form builder, click the blue circle/+ icon to open the window of available actions:

adding new action in the Emails and Actions tab

Select Emma from the list to add it to the Emails & Actions tab

Emma action in Ninja Forms

Configuring your Emma action

Click on the new Emma action in your Emails & Actions tab, and choose the Emma list you would like the user subscribed to.

Note: You may need to refresh the list. To do this, click the icon beside the “List” label.
Refreshing Emma list in Ninja Forms action

With your list selected, the fields from your Emma list will populate below the list dropdown. You’ll need to map these fields to the corresponding fields on your Ninja Form using the merge tags for those fields via the merge tag icon on the right of each Emma field.

Mapping fields


Adding an Emma Opt-in field to your form

The Emma Opt-in field gives the user an option to choose if they want to be added to a Emma list.

To add a Emma Opt-in field to your form, click on the blue add field button, then choose the Emma Opt-in.

Emma Optin fieldIf the Emma Opt-in field is checked, the Emma Action will be processed and the user will be added to the list.
If the Opt-in is unchecked, the Emma Action will be ignored.