SimplyOnce Forms API

easy-to-use, no-programming-required web form submissions

What's It Do?

If you know how to make an html form, and you want the results emailed to you in a human-readable format (no "mailto:" on the action, now), you've come to the right place. We've gotten so many requests for this sort of thing that we'd like to offer you an easy way.

Form Action / REST Endpoint

Set the action on your form (point your AJAX handler, send your POST variables) to this url: http://forms.simplyonce.com/v2/post

Changelog:

2.0: we added handling for File Attachments

3.0: we added Spam Filtering

Sample Code

<form action="http://forms.simplyonce.com/v1/post" method="post">
  <input type="hidden" name="_to" value="you(at)yourdomain.com" />
	
  <input type="text" name="email" value="Enter Email Here" />
  <input type="submit" value="Subscribe" />
</form>

Field Names / Parameters

All variables must be HTTP Post variables (the method on your form should be "post").

• _to (required)

  
  Comma-delimited list of email addresses to which to send the results. You can even use (at) instead of @ to stop spambots in their tracks!
  <input type="hidden" name="_to" value="you@yourdomain.com,5551234567@txt.att.net" />

• _subject (optional)

  
  Subject for the email sent with the results.
  <input type="hidden" name="_subject" value="Form Submission Via forms.simplyonce.com" />

• _return (optional)
  
  How to return whether we think the email sent properly. Accepted Values:
  • url (redirect to "url". i.e. http://yourdomain.com/success.php)
  • referer (redirect back to form page -- default)
  • JSON (for AJAX requests)
  • XML (for AJAX requests)
  <input type="hidden" name="_return" value="referer" />

  NOTE: For url redirects, we'll append a GET parameter telling whether it worked ( url?stat=success ) or failed ( url?stat=fail )

• _format (optional)
  
  Format of data sent in email. Accepted Values:
  • text (plain-text message body -- default)
  • csv (comma-separated-values attached file)
  <input type="hidden" name="_format" value="text" />
• _sort (optional)
  
  Whether to sort result data by fieldname (alphabetically). Accepted Values:
  • true (sort result data by fieldname)
  • false (maintain same order as form -- default)
  <input type="hidden" name="_sort" value="false" />
  
• File Attachments
  
  We currently support the following file types:
  • image/gif
  • image/jpeg
  • image/pjpeg
  • image/png
  
  <input type="file" name="filename" />

  NOTE: Make sure to set your form's "enctype" attribute to "multipart/form-data"!

  
  
• All Other Fields with a "name" attribute (not beginning with an underscore "_") will be treated as data submitted by the visitor.

Sample Form:

Parameters

_to:
_subject:
_return: referer http://www.google.com/ json xml
_format: text csv
_sort: true false

Form Data

Name:
Email:
Website:
Message: