Documentation - NoCodeSubmit

Getting Started

NoCodeSubmit provides a simple way to handle form submissions on static websites without any backend code. Just point your form's action to our endpoint and we'll handle the rest.

Quick Start

Here's a basic example of a contact form:

<form action="https://api.nocodesubmit.com/email/[email protected]" method="POST">
    <input type="text" name="name" placeholder="Name" required>
    <input type="email" name="email" placeholder="Email" required>
    <button type="submit">Send</button>
</form>

Form Setup

Setting up your form is straightforward. Replace [email protected] in the action URL with your email address. We'll send all form submissions to this email.

Required Fields

action: Your form endpoint URL (https://api.nocodesubmit.com/email/[email protected])
method: Must be "POST"

Form Field Names

You can use any field names in your form, except for special field names that start with an underscore (_).

Common field names:

name: Sender's name
email: Sender's email (used for reply-to)
subject: Message subject
message: Message content

Special Fields

Special fields allow you to customize the behavior of your form. All special fields start with an underscore (_).

Available Special Fields

Field Name	Description	Example
`_subject`	Custom email subject	`New Contact Form Submission`
`_cc`	Send copies to other emails (comma-separated)	`[email protected],[email protected]`
`_next`	URL to redirect after submission	`https://your-site.com/thanks`
`_template`	Email template style	`table`, `card`, or `minimal`
`_captcha`	Enable/disable CAPTCHA	`true` or `false`
`_honey`	Honeypot field for spam protection	Leave empty, hide with CSS

Example form with special fields:

<form action="https://api.nocodesubmit.com/email/[email protected]" method="POST">
    <!-- Special Fields -->
    <input type="hidden" name="_subject" value="New Contact Form">
    <input type="hidden" name="_next" value="https://your-site.com/thanks">
    <input type="hidden" name="_template" value="card">

    <!-- Form Fields -->
    <input type="text" name="name" placeholder="Name" required>
    <input type="email" name="email" placeholder="Email" required>
    <button type="submit">Send</button>
</form>

Email Templates

Customize how your form submissions look in your inbox using the _template field.

Available Templates

table (default): Clean table layout with labels and values
card: Modern card design with better visual hierarchy
minimal: Simple text format for maximum compatibility

Spam Protection

NoCodeSubmit includes several features to protect your forms from spam:

1. Email Verification

The first time you receive a submission from a new form, we'll send you a verification email. This ensures that only authorized email addresses can receive form submissions.

2. Honeypot Field

Add a hidden honeypot field to catch automated submissions:

<!-- Add this to your form -->
<input type="text" name="_honey" style="display:none">

3. CAPTCHA Protection

Enable or disable CAPTCHA verification using the _captcha field:

<input type="hidden" name="_captcha" value="true">

Redirects

After a successful form submission, you can redirect users to a thank you page using the _next field:

<input type="hidden" name="_next" value="https://your-site.com/thanks">

For security reasons, the redirect URL must be on the same domain as your form.

Webhooks

Send form submissions to your own endpoint or third-party services using webhooks. This allows you to process form data in real-time.

Setting Up a Webhook

Add the _webhook field to your form:

<input type="hidden" name="_webhook" value="https://your-webhook.com/endpoint">

Webhook Payload

Your webhook will receive a JSON payload with all form data:

{
  "form_data": {
    "name": "John Doe",
    "email": "[email protected]",
    "message": "Hello world"
  },
  "metadata": {
    "timestamp": "2024-01-01T12:00:00Z",
    "ip": "xxx.xxx.xxx.xxx",
    "user_agent": "Mozilla/5.0..."
  }
}

API Reference

Complete reference of all available configuration options and features.

Endpoint URL

https://api.nocodesubmit.com/email/[email protected]

HTTP Methods

POST: Submit form data
GET: Not supported

Response Codes

Code	Description
200	Form submitted successfully
302	Redirecting to thank you page
400	Invalid form data
403	Email not verified
429	Too many requests