Create a Form

It’s really easy to create a form. In fact, you don’t even have to register an account to create a form and get started. Formingo is completely free up to 500 form submissions per month.

Simple Example

A simple example might look something like this:

<form method="POST"
      action="https://www.formingo.co/submit/john@example.com">
    <label for="full_name">Full Name</label>
    <input type="text" name="full_name" id="full_name">

    <label for="__replyto">Email Address</label>
    <input type="email" name="__replyto" id="__replyto">

    <input type="submit" value="Subscribe">
</form>

As you can see, the form is no different than if you had created it to POST to your own endpoint. Notice the email address, “john@example.com,” in the form action URL. This is the email address that the form data will be sent to. You must change this value to your own email address.

Email Confirmation

To help prevent people from creating forms that send emails to email addresses not owned by them, you must confirm your email address when you create a new form. Once you submit a form for the first time, a confirmation email will be sent with a link. This link must be clicked to receive form submissions.

Once the confirmation link is clicked, you will receive all of the form submissions that were created before your email address was confirmed. This way, you’ll never lose any submissions, even if it takes a couple minutes for the confirmation email to arrive.

You must confirm your email address for every referrer-email address combination. This means that if you embed your form on the page “http://www.example.com/contact” and have it submit to “john@example.com”, you will receive a confirmation link that enables submission for the contact page only. If you copy the form and paste it onto another page, such as “http://www.example.com/help”, you will receive a second confirmation link, even if the email address is unchanged.

Special Fields

Formingo uses fields with special names to configure certain options. Configuration option field names always begin with two underscore characters (i.e. “__”).

__redirect

You can specify a “__redirect” field with a URL that the user will be redirected to once they submit the form. If you do not specify a URL, they will be shown a “Thank You” message on the Formingo website. The following example form redirects a user to “http://www.example.com/thank-you” instead of showing the default Formingo “Thank You” page.

<form method="POST"
      action="https://www.formingo.co/submit/john@example.com">
    <label for="full_name">Full Name</label>
    <input type="text" name="full_name" id="full_name">
    
    <input type="hidden" name="__redirect" value="http://www.example.com/thank-you">

    <input type="submit" value="Subscribe">
</form>

__replyto

A field with the name “__replyto” sets the “reply to” email address of the form submission email. This way, once you receive the submission data over email, you’ll be able to immediately click “reply” and respond to your visitor. For example, the following form would allow for your visitor to enter his or her email address and let you respond directly to them.

<form method="POST"
      action="https://www.formingo.co/submit/john@example.com">
    <label for="full_name">Full Name</label>
    <input type="text" name="full_name" id="full_name">

    <label for="__replyto">Email Address</label>
    <input type="email" name="__replyto" id="__replyto">

    <input type="submit" value="Subscribe">
</form>

__subject

The “__subject” field allows you to change the name of the subject for the form submission email. For example, the following form sends an email with the submission data titled “You Received a New Contact”. Notice how the input is actually hidden— this allows you to set the subject without allowing your visitor to modify it from the form itself. You can also set it to a “text” type if you want it to be user-modifiable.

<form method="POST"
      action="https://www.formingo.co/submit/john@example.com">
    <label for="full_name">Full Name</label>
    <input type="text" name="full_name" id="full_name">
    
    <input type="hidden" name="__subject" value="You Received a New Contact">

    <input type="submit" value="Subscribe">
</form>