Quick Start Guide

Get up and running with Submeto in under 2 minutes.

1. Create your account

Sign up for free and create your first form endpoint from the dashboard. You'll receive a unique Form ID and a Secret Token for API access.

2. Add the form to your site

Set your HTML form's action attribute to your Submeto endpoint. No JavaScript required.

contact.html

<form action="https://submeto.com/forms/YOUR_FORM_ID" method="POST">
  <input type="text" name="name" placeholder="Name" required />
  <input type="email" name="email" placeholder="Email" required />
  <textarea name="message" placeholder="Message"></textarea>
  <button type="submit">Send</button>
</form>

3. File uploads

To accept file uploads, add enctype="multipart/form-data" to your form and include file inputs.

upload.html

<form
  action="https://submeto.com/forms/YOUR_FORM_ID"
  method="POST"
  enctype="multipart/form-data"
>
  <input type="text" name="name" required />
  <input type="file" name="resume" />
  <button type="submit">Upload</button>
</form>

4. Programmatic API access

For JavaScript apps or server-to-server integrations, use the REST API endpoint. Include your form's secret token in the Authorization header.

submit.js

const response = await fetch(
  "https://submeto.com/api/v1/forms/YOUR_FORM_ID",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_FORM_TOKEN",
    },
    body: JSON.stringify({
      name: "Jane Doe",
      email: "jane@example.com",
      message: "Hello!",
    }),
  }
);

const data = await response.json();
console.log(data.message); // "Submission received"

Or with cURL:

terminal

curl -X POST https://submeto.com/api/v1/forms/YOUR_FORM_ID \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_FORM_TOKEN" \
  -d '{"name": "Jane", "email": "jane@example.com"}'

5. Custom redirect

Add a hidden _redirect field to send users to a custom thank-you page after submission.

form.html

<!-- Redirect after submission -->
<form action="https://submeto.com/forms/YOUR_FORM_ID" method="POST">
  <input type="hidden" name="_redirect" value="https://yoursite.com/thank-you" />
  <input type="text" name="name" required />
  <button type="submit">Send</button>
</form>

Endpoint Reference

Endpoint	Auth	Use Case
POST /forms/{id}	None (origin whitelist)	HTML form submissions
POST /api/v1/forms/{id}	Bearer token	Programmatic API access

Supported Content Types

application/x-www-form-urlencoded — Standard HTML forms
multipart/form-data — Forms with file uploads
application/json — API/JavaScript submissions

Using an AI coding assistant?

Share this page's URL with your AI tool (e.g. Claude Code, Cursor, Copilot) and it can read the documentation to integrate Submeto into your project automatically.

https://submeto.com/docs

Need help?

If you run into any issues, reach out to us at support@submeto.com.