Email

One of the actions available on forms is the Email action. This will send out an email or emails. This can be to an administrator email or to an email address entered on the form.

In order to send the emails out an email provider needs to be configured. By default we provide a Sendgrid account that may be used for low volumes of emails.

There are several other email providers that may be set up and monitored for your application. They can be configred in the Project Settings.

Gmail

You can use gmail for sending emails through form.io. Enter your email address and password to use gmail.

Use caution if you use Gmail as there are limitations to how many and the types of emails Gmail will allow.

Kickbox

There are many situations where you need to validate a persons email address in realtime as they fill out the form, and fail the form submission if the email is invalid. A good example use case for this would be at an industry conference where you need to ensure that everyone who signs up at your booth provides a valid email address in order to win that amazing prize drawing. In order to provide this capability, Form.io has teamed up with an amazing email validation service called Kickbox.io to provide realtime email validation to the Form.io forms.

Getting Started

The first thing you will need to do to enable realtime email validations is to create an account @ Kickbox.io. Once you have created an account, you will need to create a new Verify API configuration.

Next, you will click on the New App button, and then provide your application a name and then Production. Note: You may want to use Sandbox to perform some tests to ensure it works. The sandbox allows you to use some predetermined email addresses that return certain results for you to test the application. You can find out more about how this works by visiting the Sandbox API documentation.

After you create an application, you will next copy the API Key provided and use it to configure your Form.io Project Settings.

Configuring Form.io Project

Once you have your Kickbox.io account, the next thing you will need to do is configure your Form.io Project with the API key provided from Kickbox.io. Follow the steps provided in the following image.

Make sure you press Save Settings when you configure your API Key.

The next step is to create a form that will require Email input. As an example, we will make a simple Contact Us form for our website and include the Email.

For the Email component, we will want to make sure we configure the settings under the Validation tab to enable Kickbox validation.

Now Save the Form*.

Finally, to ensure that this form can be submitted by Anonyous people, go into the Access tab and allow Anonymous to create their own submissions.

Make sure you press the Save Changes button to save the new permissions.

You can now test out your form by going to the Launch section, click on A Single Form, and then click on the Launch button next to the Contact Us form.

You can now try out the Kickbox validation system by filling out the form and trying to submit an invalid email address. Congrats, you now have real-time email validation!

Sendgrid

To use Sendgrid as an email transport, go to sendgrid and sign up for an account.

After signing up you will get an API key. Enter the API key into the settings field and select the Sendgrid in the Email Action.

Mandrill

To use Mandrill as an email transport, go to mandrill and sign up for an account.

After signing up you will get an API key. Enter the API key into the settings field and select the Mandrill in the Email Action.

Mailgun

To use Mailgun as an email transport, go to mailgun and sign up for an account.

After signing up you will get an API key. Enter the API key into the settings field and select the Mailgun in the Email Action.

You will also need to verify a domain to be able to send emails from a domain. Once done verifying your domain, enter the domain name in the domain field.