Skip to content

v-ishnu/Form2Mail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

57 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“§ Form2Mail

Seamlessly receive form submissions via email AND store them in Google Sheets A complete solution for capturing, notifying, and organizing form data without backend code.

Effortlessly capture form submissions with instant email delivery and automated Google Sheets logging - no backend code required. The perfect solution for static sites, GitHub Pages, and JAMstack projects.

Form2Mail Demo

✨ Key Features

  • Zero backend setup - works with static sites
  • Spam protection – reCAPTCHA
  • Instant email notifications on form submission
  • Auto-save to Google Sheets in real-time
  • Secure processing via Google Service Account
  • Success/error notifications – User feedback after submission
  • Community-driven – Feature voting and discussion

βš™οΈ How It Works

  1. Point Your Form: Set your HTML form's action attribute to the Form2Mail endpoint with your email address.
  2. First-Time Verification: The first time an email address is used, we send a verification link. This is a one-time security step to confirm ownership and prevent abuse.
  3. Receive Data: Once verified, all future submissions from that form are sent directly to your email and, if configured, your Google Sheet.

πŸš€ Quick Start

1. Email-Only Setup (Simple Version)

Perfect when you just need form submissions sent to your inbox Get form submissions straight to your inbox!

  1. Copy this ready-to-use form code:

    <form action="https://www.form2mail.dinestx.com/api/v.01/your@email.com" method="POST">
    
       <label for="name">Name</label>
         <input type="text" id="name" name="Name" required>
    
         <label for="email">Email</label>
         <input type="email" id="email" name="Email" required>
    
         <label for="message">Message</label>
         <textarea id="message" name="Message"></textarea>
    
         <button type="submit">Send</button>
    </form>
  2. Just change one thing:

    Replace your@email.com with your actual email address

       https://www.form2email.dinestx.com/api/v.01/your@email.com
  3. That's it! Submit the form, check your inbox for the one-time verification link, and you're ready to go.

2. Form2Mail with Google Sheets Integration

In addition to email, automatically save submissions to a Google Sheet.

Prepare Your Google Sheet

  1. Create a Google Sheet: Make a new, empty Google Sheet.

  2. Share with Service Account:

    • In the "Add people and groups" field, enter:form2mail@dinestx.iam.gserviceaccount.com
    • Set the permission to Editor and click Send.
  3. Update Your Form's Action:

Add the sheet query parameter to the action URL with your Sheet ID.

   <form action="https://www.form2mail.dinestx.com/api/v.01/your@email.com?submit=Your_Google_Sheet_Id" method="POST">
      // Your Form Code
    </form>
  1. Find Your Sheet ID: The Sheet ID is the long string of characters in the URL of your Google Sheet. https://docs.google.com/spreadsheets/d/`1BiF_PwhXHuNgWENADfQQHTFfDpjGb-zri8MdXv3onnQ`/edit

    Your_Google_Sheet_Id: 1BiF_PwhXHuNgWENADfQQHTFfDpjGb-zri8MdXv3onnQ

βš™οΈ Form Configuration Options

Parameter Description Default
name= "Name" Capital Name can be Shown in Your email Table name="name"
name= "Email" Capital Name can be Shown in Your email Table name="email"
name= "Mobile" Capital Name can be Shown in Your email Table name="mobile"

πŸ’¬ Feature Discussions

We welcome community input! Here's how to contribute:

Current Feature Requests

Feature Request πŸ‘ Votes Status Discussion
File attachments 01 Planned #4

ℹ️ Click the issue numbers above to view or join the discussion.

How to Participate

  1. Vote on existing requests by adding a πŸ‘ reaction
  2. Suggest new features by opening an issue
  3. Discuss ideas in our Discussions tab

🚨 Troubleshooting Guide (for Users)

If you encounter issues, please check the following:

πŸ“§ Not Receiving Emails?

If you're not receiving form submission emails:

  • Make sure you entered a valid email address
  • Check your Spam or Junk folder
  • Try using a different email provider (Currently, We only support Gmail)
  • If you're using a custom domain (e.g. you@yourdomain.com), ensure your domain is able to receive external emails

⚠️ Form Not Submitting?

If the form is not submitting properly or shows an error:

  • Ensure your internet connection is working
  • Refresh the page and try again
  • Complete the reCAPTCHA challenge (the β€œI’m not a robot” box)
  • If a link was emailed to you for verification:
    • Make sure you click the link within 15 minutes
    • Check that the link is not broken or expired
  • Make sure JavaScript is enabled in your browser

πŸ§ͺ Still Having Issues?

  • Try using a different browser (e.g. Chrome or Firefox)
  • Try submitting the form from a different device
  • If nothing works, reach out to the site owner for help

πŸ’¬ If this service was embedded on another website (like a contact form), please contact the website owner directly β€” Form2Email does not store your messages.


🀝 Contributing

Contributions are welcome! If you have ideas for improvements or want to fix a bug, please read our Contribution Guidelines to get started.

πŸ“œ License

This project is distributed under the GNU General Public License v3.0. See LICENSE for more information.


πŸ“¬ Contact

Vishnu Prakash – @v-ishnu – vishnuprakash572@gmail.com
Project Link – https://github.com/v-ishnu/Form2Mail

About

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published