Form Submission API

API Overview

The FormsList API has two parts: the submission endpoint for receiving form data, and the management API for reading submissions and configuring forms. The submission endpoint requires no authentication — your unique form hash identifies the form. The management API uses bearer token authentication.

Base URL: https://formslist.com

Endpoints

Code Examples

cURL

curl -X POST https://formslist.com/f/YOUR_FORM_HASH \
  -H "Content-Type: application/json" \
  -d '{"name": "Jane", "email": "jane@example.com", "message": "Hello!"}'

JavaScript (fetch)

const res = await fetch("https://formslist.com/f/YOUR_FORM_HASH", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Jane",
    email: "jane@example.com",
    message: "Hello!",
  }),
});
const data = await res.json();
console.log(data); // { success: true }

Python (requests)

import requests

resp = requests.post(
    "https://formslist.com/f/YOUR_FORM_HASH",
    json={"name": "Jane", "email": "jane@example.com", "message": "Hello!"},
)
print(resp.json())  # {"success": True}

Authentication

The submission endpoint (POST /f/:hash) does not require authentication. The form hash in the URL identifies the target form.

The management API (/api/v1/*) requires a bearer token. Generate an API key in your FormsList dashboard under Settings → API Keys. Include it in the Authorization header:

Authorization: Bearer your_api_key_here

Rate Limits