Quick Start Guide

This guide will help you create your first form using the GeniusForms API.

Prerequisites

A GeniusForms account (Sign up free)
An API key from your dashboard

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.

Step 2: Create a Form

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}
    ]
  }'

Step 3: Publish Your Form

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

Getting Started

Guides

Quick Start

Quick Start Guide

Prerequisites

Step 1: Get Your API Key

Step 2: Create a Form

Step 3: Publish Your Form

Step 4: Collect Responses

Next Steps

Pricing & Credits

Question Types

API Reference

​Quick Start Guide

​Prerequisites

​Step 1: Get Your API Key

​Step 2: Create a Form

​Step 3: Publish Your Form

​Step 4: Collect Responses

​Next Steps

Pricing & Credits

Question Types

API Reference

Quick Start Guide

Prerequisites

Step 1: Get Your API Key

Step 2: Create a Form

Step 3: Publish Your Form

Step 4: Collect Responses

Next Steps