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

Need help?

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