Emma

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.EM_1

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.

[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:

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

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.
EM_5

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.

 

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.

If 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.