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.
You have two options: generate with AI or create manually.
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 questions" }'
Create a form with specific questions: 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} ] }'
Forms are unpublished by default. Publish to make it accessible:
curl -X POST https://geniusforms.ai/api/v1/forms/YOUR_FORM_ID/publish \ -H "X-API-Key: YOUR_API_KEY"
The response includes your public form URL:
{ "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"
Response:
{ "responses" : [ { "id" : "session_abc123" , "submittedAt" : "2026-02-06T10:30:00Z" , "data" : { "Your name" : "John Doe" , "Your email" : "john@example.com" , "Your message" : "Hello, I'd like to learn more about your services." } } ], "total" : 1 }
AI form generation costs 5 credits per call. Free accounts get 50 credits/month. Check your balance anytime with the X-Credits-Remaining response header or the GET /usage endpoint. See Pricing & Credits for details. Next Steps
Pricing & Credits Understand the credit system and plans
Question Types Explore all 15+ supported question types
API Reference Full API documentation
