Form2Channel Docs

Contents

Basic Form setup

1. Add this form tag
   

   <form action="https://form2channel.com" method="POST">

2. Add hidden tags for form recipients (see example form) like
   

   <input type="hidden" name="formto_googlesheets" value="me@email.address">

   <input type="hidden" name="formto_email" value="me@email.address">

3. Upload the page to your server
   Localhost is not allowed

For submissions to Google Sheets or Email no further setup is necessary

Adding multiple forms

When adding multiple forms to one website include a form identifyer in the form action querystring like

<form action="https://form2channel.com/?form=contactus" method="POST">

<form action="https://form2channel.com/?form=customerinfo" method="POST">

Adding multiple recipients

Comma-separate multiple recipients for a channel

<input type="hidden" name="formto_email" value="me@email.address, me2@email.address">

<input type="hidden" name="formto_googlesheets" value="me@email.address, me2@email.address">

Thank you and error pages

By default the process redirects visitors to the website default page with the result in the querystring like

result={"Message":"Form submitted","Success":true}

You can add the hidden field below into your form to redirect visitors to after a successful or failed submission

<input name="formto_redirect" type="hidden" value="Url or page to redirect visitors to on success">

<input name="formto_error" type="hidden" value="Url or page to redirect visitors to on error">

File uploads

Forms that contain file upload tags must have the enctype="multipart/form-data" attribute, like so

<form action="https://form2channel.com" method="post" enctype="multipart/form-data">

Add any number of single or multiple file upload tags to the form, like so

<input type="file" name="fieldname1">

<input type="file" name="fieldname2[]" multiple>

The following limits and cautions apply to file uploads

1. Max size per file: 20MB
   Larger files are discarded

2. Max POST size: 40MB
   Larger posts will fail
3. File retention: 30 days
   Files are deleted after 30 days
4. File accessibility not restricted
   Until deletion all files are accessible to anyone with the url
5. File safety not guaranteed
   Files have not been scanned for viruses

<input type="hidden" name="formto_http" value="Address of the receiving webhook or api">

    [
        {"key":"FirstName","value":"John"},
        {"key":"LastName","value":"Lennon"},
        {"key":"Country","value":"United Kingdom"},
        {"key":"Subscribed","value":"checked"},
        {"key":"Gender","value":"Male"},
        {"key":"File","value":"https://form2channel.com/images/built-with-linx.svg"}
    ]

Post your data directly to our Linx REST API

You can skip the form altogether and submit your data directly to our API as a Json object

• URI: https://showcase.api.linx.twenty57.net/Form2Channel
• Method: POST
• Content Type: application/json
• Body: Array of key / value pairs as shown below

    [
        {"key":"formto_email","value":"me@email.address"},
        {"key":"formto_email","value":"me2@email.address"},
        {"key":"formto_googlesheet","value":"me@email.address"},
        {"key":"FirstName","value":"John"},
        {"key":"LastName","value":"Lennon"},
        {"key":"Country","value":"United Kingdom"},
        {"key":"Subscribed","value":"checked"},
        {"key":"Gender","value":"Male"},
        {"key":"File","value":"https://form2channel.com/images/built-with-linx.svg"}
    ]

1. Message (String)
2. Success (boolean)

{"Message":"Form submitted","Success":true}

API limits

To prevent our API from being abused to spam recipients, the following limits apply

1. Add up to 10 email recipients per IP address every 10 days
2. Add up to 10 Google Sheet recipients per IP address every 10 days
3. Submitting from locally hosted pages is not permitted