Getting Started - Formcarry Documentations

What is Formcarry

Formcarry allows you to collect submissions from your own HTML form, without any back-end code. You can get notification emails for submissions, upload files from your form, use best-in-class spam protection and integrate with other apps.

How to use formcarry to collect submissions?

Before we start, here’s what you’ll need:

A Formcarry account

An HTML form

Optionally, basic Javascript knowledge

1. Creating an HTML Form

Create a simple newsletter form using HTML:

html
<form action="#" method="POST">
	<label for="email">What is your Email Address?</label>
	<input type="email" name="email" id="email">
	<button type="submit">Subscribe</button>
</form>

Check out our free contact form generator if you don’t have any written HTML form yet, by using this free tool you can customize and create a working contact form that works with formcarry without any further configuration

💡

Deeper Knowledge

The biggest key point of an HTML form is action="#" part, you specify the URL where you want to process form data, basically it will look like this in a normal website:

html
<form action="https://mysite.com/form.php" method="POST">
	<label for="email">What is your Email Address?</label>
	<input type="email" name="email" id="email">
	<button type="submit">Subscribe</button>
</form>

What that does is, pointing all of your form data to https://mysite.com/form.php, and you have to write some PHP (or any other back end language like Nodejs, Go or Ruby ) to process the data that you got from this HTML form

This is where formcarry comes in, instead of writing your own back-end code, formcarry will create an unique URL that is ready to process your form without any code.

Your unique URL allows you to get emails from your form, send auto-responses, upload files and trigger Zapier zaps, basically more than you expect from a HTML form.

An example formcarry endpoint looks like this:

https://formcarry.com/s/XXXXXXXX

2. Creating a form in Formcarry

Go to your dashboard and you’ll see “Create Form” button at the top right of the navigation:

Click the button and you’ll see the form creation modal:

Click setup tab and you’ll see your unique form endpoint, and copy it

💡

Your unique endpoint is a bridge between your form and formcarry that will deliver submissions.

3. Integrating your form to formcarry

Just paste the unique endpoint URL that you got in step 2. into your forms action attribute:

html
//this is sample endpoint change it with your endpoint that you copied in step 2
<form action="https://formcarry.com/s/{YOUR UNIQUE ENDPOINT}" method="POST">
	<label for="email">What is your Email Address?</label>
	<input type="email" name="email" id="email">
	<button type="submit">Subscribe</button>
</form>

That's all you need to collect submissions!

💡

Important Note: All of the fields (input, textarea, select) need to have a name attribute, otherwise formcarry can't parse the data of the field.

Now, you're ready to collect submissions, let's try it:

💡

To customize your thank you page take a look at Thank You Pages

Get into your form from the dashboard, then click the submissions tab:

Tadaa! it's here 🎉, well done!

This is not even the limit! By using Formcarry you will be able to do following:

✅ File uploads

✅ Google Recaptcha

✅ Spam Blocking

✅ Zapier Integration

✅ Webhooks

✅ CSV & JSON export

✅ Autoresponses

Do's and Dont's

Each input field must have name attribute

html
<input type="email" name="email">
<input type="text" name="firstName">
<input type="text" name="lastName">
<input type="text" name="anotherInput">

Content-Type: json, form-data and x-www-form-urlencoded is supported, if you're just using HTML form without javascript, you don't have to worry, but if you are using javascript to make request, you should set this.

If you need to upload files Content-Type should be multipart/form-data.

If you want to get response message as JSON, you must set HTTP Accept header to application/json