Documentation

Complete setup instructions, API reference, and troubleshooting guides to help you integrate ForgedForms into your projects.

Getting Started

ForgedForms makes it incredibly simple to handle form submissions without any backend code. Follow these steps to get up and running in minutes.

1Create Your Account

Sign up for ForgedForms by pressing the Get Started button above.

2Create Your First Form

Once logged in, create a new form project from your dashboard. Give it a meaningful name like “Contact Form” or “Newsletter Signup”.

  • Set up email notifications
  • Configure your notification email address
  • Add a description for easy identification

3Get Your Form Endpoint

Copy your unique form endpoint URL from the dashboard. It will look something like:

https://forgedforms.com/api/forms/{form-id}/submit

4Start Collecting Submissions

Point your HTML form to the endpoint and start receiving submissions in your dashboard with instant email notifications!

Basic Setup

HTML Form

The simplest way to use ForgedForms is with a standard HTML form:

<form action="https://forgedforms.com/api/forms/{form-id}/submit" method="POST">
  <input name="name" type="text" placeholder="Your Name" required />
  <input name="email" type="email" placeholder="Email Address" required />
  <textarea name="message" placeholder="Your Message" required></textarea>
  <button type="submit">Send Message</button>
</form>

React/Next.js Example

For React applications, you can handle form submissions with JavaScript:

const ContactForm = () => {
  const handleSubmit = async (e) => {
    e.preventDefault();
    const formData = new FormData(e.target);
    
    const response = await fetch('https://forgedforms.com/api/forms/{form-id}/submit', {
      method: 'POST',
      body: formData
    });
    
    if (response.ok) {
      alert('Message sent successfully!');
      e.target.reset();
    }
  };

  return (
    <form onSubmit={handleSubmit}>
      <input name="name" type="text" placeholder="Your Name" required />
      <input name="email" type="email" placeholder="Email" required />
      <textarea name="message" placeholder="Message" required></textarea>
      <button type="submit">Send Message</button>
    </form>
  );
};

JSON Submissions

You can also send JSON data directly:

const submitForm = async (data) => {
  const response = await fetch('https://forgedforms.com/api/forms/{form-id}/submit', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
  });
  
  return response.json();
};

Troubleshooting

Common Issues

Form not submitting

• Make sure your form's action URL is correct and that the method is set to “POST”.

• Check that your form ID is active in your dashboard.

Not receiving emails

• Check your spam folder and verify your email address in the dashboard settings.

• Ensure email notifications are enabled for your form.

CORS errors

Our API automatically handles CORS. If you're still getting errors, make sure you're using the correct endpoint URL and your form is active.

Rate limit exceeded

You've reached your monthly submission limit. Upgrade your plan or wait for the limit to reset next month.

Need More Help?

Can't find what you're looking for? We're here to help!