API Reference

Integrate Forma into your applications. Submit form data from anywhere using our simple REST API.

Quick Start

Send a POST request to your form's endpoint with JSON data. No authentication required for submissions.

POST/api/forms/<FORM_ID>/submissions

Code Examples

curl -X POST https://yourapp.com/api/forms/FORM_ID/submissions \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello from the API!"
  }'

Response Format

Success (200)

{
  "success": true,
  "submission": {
    "id": "clx123abc...",
    "createdAt": "2024-01-15T..."
  }
}

Error (4xx/5xx)

{
  "error": "Form not found or not active"
}

// Or for limit reached:
{
  "error": "Monthly submission limit reached"
}

API Keys (Optional)

Form submissions don't require authentication. API keys are for accessing your data programmatically:

•List forms and submissions
•Create and manage forms via API
•Export data programmatically

Include your API key in requests:

Authorization: Bearer frm_live_xxxxx

Get Your API Key

Rate Limits

100

Requests/minute

Submissions/month (Free)

Unlimited

Submissions (Pro)

Need Help?

Having trouble integrating? Check out our examples or reach out to support.

Contact Support