Form endpoint for developers

Connect Website Forms Without a Separate Backend

Send HTML, JavaScript, TypeScript, React, Next.js and static site forms to a SmartFormify endpoint. Each accepted submission is saved and returns a clear success response.

Create Endpoint Endpoint Overview

Endpoint examples

html

<form
  action="https://api.smartformify.com/fe/YOUR_ENDPOINT_KEY"
  method="POST"
>
  <label>
    Name
    <input name="name" required>
  </label>

  <label>
    Email
    <input type="email" name="email" required>
  </label>

  <label>
    Message
    <textarea name="message" required></textarea>
  </label>

  <button type="submit">Send</button>
</form>

Quick start

Connect an endpoint in three steps

STEP 1

Create an endpoint

Create an endpoint and copy its public submission URL.

STEP 2

Send the form

Use a normal HTML form action or send a JSON request from the browser.

STEP 3

Handle the result

Show the returned message or redirect, then review the saved submission.

Choose an implementation guide

Each guide shows the request, response handling and setup details for that project type.

HTML form action

Send a normal POST form. SmartFormify redirects the browser or displays the configured thank-you content.

JavaScript and JSON

POST application/json with submitted fields inside data, then handle the returned status and response body.

TypeScript

Define the request fields and narrow typed success and failure responses.

React

Use a browser fetch handler with validation, loading, success, and error state.

Next.js

Submit from an App Router client component or use the same handler in a Pages Router component.

Static sites

Use a normal form action on a deployed static page without adding a server function.

Endpoint request and limits

Use the endpoint URL shown in the dashboard. The examples above show the accepted request formats and returned JSON.

Request and response rules

POST to the /fe/{submit_key} URL
Use a flat browser form or a JSON data object
Read redirect_url or thank_you_content after success
Use result.message for a failed JSON request
Use Idempotency-Key when a client may retry the same request

Current technical limits

These are the current backend defaults. Deployment settings can change rate and body limits.

Up to 30 submitted fields per request
Field names up to 80 characters
Text values up to 5,000 characters
Request bodies up to 128 KB by default
Default rate window: 120 requests per endpoint key and 60 per IP per minute

Public key and domain controls

The submit key is part of the public endpoint URL and can be used by browser code. Restrict the endpoint to the expected domains. Regenerating the key invalidates the old URL.

Spam and validation controls

SmartFormify can block listed domains, IP addresses, phrases, and submissions containing links. Client validation remains useful for clear field errors.

Deployment check

Test before deployment

Run these checks from the environments that will submit directly to the endpoint.

1
Add the local or preview domain to the endpoint settings
2
Send one valid submission and one invalid submission
3
Check the loading, success and error states
4
Check the redirect or thank-you content
5
Confirm the submission appears in the inbox and email notification
6
Remove temporary domains when testing is complete

Ready to test

Connect the project form

Create an endpoint, add its submission URL to the form and send a test from the project domain.

Create Endpoint