Serverless Email Forms

Create HTML forms that send an email when submitted. Easy contact form embedding for static sites and frontend no-code widgets.

  • Table of contents

Just POST any HTML form to:

https://api.mailslurp.com/forms<em>?_to</em>=<strong>you@mail.com

Form fields are sent directly to your inbox seconds later. Even attachments!

Basic usage

Include any form fields you like, MailSlurp will create a table with the data and email it to the email address provided by the _to query parameter or form field name.

<form action="https://api.mailslurp.com/forms?_to=YOUR_EMAIL" method="post">
  <!-- include any form fields, even files -->
  <textarea name="example"></textarea>
</form>

When the form is submitted MailSlurp determines the _to email address and emails the form data and files to the address.

Configuration options

You can control behavior of the form and email using meta parameters. The parameters tell MailSlurp how to handle the form and can be supplied in the URL or as hidden form inputs.

Example

Here is an example where the _to email address and _subject are specified as hidden form fields.

< action="https://api.mailslurp.com/forms" method="post">
  <!-- hidden meta parameters -->
  <input type="hidden" name="_to" value="you@mail.com">
  <input type="hidden" name="_subject" value="Customer contact">
  <!-- (spam check field, leave empty) -->
  <input type="hidden" name="_spamCheck" value=""/>

  <!-- visible meta parameters -->
  <!-- (_emailAddress allows you to reply to the submitter directly) -->
  <input name="_emailAddress" type="email" placeholder="Customer's email">

  <textarea name="message"></textarea>
</form>

All meta parameters

See the form API docs for more information.

Type Name Description Schema
FormData _emailAddress optional Email address of the submitting user. Include this if you wish to record the submitters email address and reply to it later. string
FormData _redirectTo optional Optional URL to redirect form submitter to after submission. If not present user will see a success message. string
FormData _spamCheck optional Optional but recommended field that catches spammers out. Include as a hidden form field but LEAVE EMPTY. Spam-bots will usually fill every field. If the _spamCheck field is filled the form submission will be ignored. string
FormData _subject optional Optional subject of the email that will be sent. string
FormData _successMessage optional Optional success message to display if no _redirectTo present. string
FormData _to optional The email address that submitted form should be sent to. Either this or _toAlias must be present for a form to be successfully submitted.. string
FormData _toAlias optional ID of an email alias to that form should be sent to. Aliases must be created before submission and can be used to hide an email address and reduce spam. string
FormData otherParameters optional All other parameters or fields will be accepted and attached to the sent email. This includes files and any HTML form field with a name. These fields will become the body of the email that is sent. string

Mask your email address

Protect your email address from spammers and bots by using an email alias. Create a MailSlurp email alias then use the ID in a _toAlias parameter.

<form action="https://api.mailslurp.com/forms" method="post">
  <!-- hide email with an alias -->
  <input
    type="hidden"
    name="_toAlias"
    value="9b32cb34-e75a-48a6-8f6c-817204c354e7"
  />
  <!-- data to submit -->
  ...
</form>

Reduce spam

Include a special <input type="hidden" name="_spamCheck"> field in your form to catch out bots and reduce spam. (MailSlurp will discard submission that fill the hidden field.)

Pricing

MailSlurp forms are 100% free! Simply point a form action to https://api.mailslurp.com/forms and receive data as soon as it is submitted.

Read the documentation →

Email and SMS Platform
Create a free account in 3 clicks