Serverless Email Forms
Create HTML forms that send an email when submitted. Easy contact form embedding for static sites and frontend no-code widgets.
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.