Submit API

Submit form data programmatically using the FormFlow API.

Endpoint

POST https://www.formflow.sh/api/submit

Authentication

Include your API key in the request headers:

X-FormFlow-API-Key: ff_live_your_api_key_here

Request

Headers

Body

Send form data as JSON. Any fields are accepted:

{
  "email": "user@example.com",
  "name": "John Doe",
  "message": "This is a test submission",
  "subject": "Contact Form"
}

Response

Success (200 OK)

{
  "success": true,
  "submissionId": "sub_abc123xyz",
  "message": "Form submitted successfully"
}

Rate Limit Exceeded (402 Payment Required)

{
  "error": "Rate limit exceeded",
  "limit": 50,
  "upgradeUrl": "https://www.formflow.sh/pricing"
}

Invalid API Key (401 Unauthorized)

{
  "error": "Invalid API key"
}

Examples

cURL

curl -X POST https://www.formflow.sh/api/submit \
  -H "Content-Type: application/json" \
  -H "X-FormFlow-API-Key: ff_live_your_api_key" \
  -d '{
    "email": "user@example.com",
    "name": "John Doe",
    "message": "Hello from cURL!"
  }'

JavaScript (fetch)

const response = await fetch('https://www.formflow.sh/api/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-FormFlow-API-Key': 'ff_live_your_api_key',
  },
  body: JSON.stringify({
    email: 'user@example.com',
    name: 'John Doe',
    message: 'Hello from JavaScript!',
  }),
});

const result = await response.json();
console.log(result);

Python (requests)

import requests

response = requests.post(
    'https://www.formflow.sh/api/submit',
    headers={
        'Content-Type': 'application/json',
        'X-FormFlow-API-Key': 'ff_live_your_api_key',
    },
    json={
        'email': 'user@example.com',
        'name': 'John Doe',
        'message': 'Hello from Python!',
    }
)

print(response.json())

Rate Limits