Quick Start Guide
This guide will help you create your first form using the GeniusForms API.
Prerequisites
Step 1: Get Your API Key
- Log in to your GeniusForms dashboard
- Navigate to Settings → API Keys
- Click Create API Key
- Copy and store your key securely (it’s only shown once!)
Never expose your API key in client-side code. Keep it on your server.
AI Generation
Manual Creation
Let AI create your form from a description:curl -X POST https://geniusforms.ai/api/v1/forms/generate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Create a contact form with name, email, and message fields"
}'
Create a form with specific fields:curl -X POST https://geniusforms.ai/api/v1/forms \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Contact Form",
"description": "Get in touch with us",
"questions": [
{"type": "text", "question": "Your name", "required": true},
{"type": "email", "question": "Your email", "required": true},
{"type": "textarea", "question": "Your message", "required": true}
]
}'
curl -X POST https://geniusforms.ai/api/v1/forms/YOUR_FORM_ID/publish \
-H "X-API-Key: YOUR_API_KEY"
{
"id": 208,
"isPublished": true,
"url": "https://geniusforms.ai/f/abc123xyz"
}
Step 4: Collect Responses
After users submit your form, retrieve responses:
curl https://geniusforms.ai/api/v1/forms/YOUR_FORM_ID/responses \
-H "X-API-Key: YOUR_API_KEY"
{
"responses": [
{
"id": "session_abc123",
"submittedAt": "2026-02-06T10:30:00Z",
"data": {
"Your name": "John Doe",
"Your email": "[email protected]",
"Your message": "Hello, I'd like to learn more about your services."
}
}
],
"total": 1
}
Next Steps
