Skip to main content

​
Quickstart Guide

In this guide, you’ll create your first form, embed it on a website, and receive submissions. Expected time: ~5 minutes.

​
Prerequisites

  • A ZeroForms account (sign up at app.zeroforms.dev)
  • A website or HTML page where you want to embed the form
  • Basic knowledge of HTML (or just copy-paste!)

​
Step 1: Create Your Access Key

  1. Log in to your ZeroForms Dashboard
  2. Navigate to Settings → Access Keys
  3. Click Generate New Key
  4. Copy your access key (starts with zf_)
Keep your access key secure! Treat it like a password. Don’t commit it to version control.

​
Step 2: Create Your Form

  1. Go to Forms → Create New Form
  2. Name your form (e.g., “Contact Form”)
  3. Add fields:
    • Name (Text)
    • Email (Email)
    • Message (Textarea)
  4. Click Save & Publish
  5. Copy the form ID

​
Step 3: Embed the Form

Copy this script tag to your HTML page: 
<script src="https://api.zeroforms.dev/forms.js" data-key="your-access-key"></script>
Replace your-access-key with your actual access key from Step 1.
That’s it! Your form is now live. Try submitting something.

​
HTML Example

<!DOCTYPE html>
<html>
<head>
  <title>Contact Us</title>
</head>
<body>
  <h1>Contact Us</h1>
  <form>
    <input type="text" name="name" placeholder="Your Name" required />
    <input type="email" name="email" placeholder="Your Email" required />
    <textarea name="message" placeholder="Your Message" required></textarea>
    <button type="submit">Send</button>
  </form>

  <!-- Add ZeroForms Script -->
  <script src="https://api.zeroforms.dev/forms.js" data-key="zf_your_key_here"></script>
</body>
</html>

​
Step 4: View Submissions

  1. Go to Submissions in your dashboard
  2. You’ll see all form responses in real-time
  3. Export data as CSV or JSON

​
Step 5: Set Up Notifications (Optional)

​
Email Notifications

  1. Go to Settings → Email Notifications
  2. Enable Email to Admin
  3. Enter your email address
  4. Choose which forms trigger notifications

​
Webhooks

Send submissions to your own server: 
curl -X POST https://api.zeroforms.dev/api/webhooks \
  -H "x-access-key: your-access-key" \
  -H "Content-Type: application/json" \
  -d '{
    "formId": "form-id",
    "url": "https://your-server.com/webhooks/submissions",
    "events": ["submission.created"]
  }'

​
What’s Next?

​
Troubleshooting

​
Form not showing?

  • Check your access key is correct
  • Ensure the script tag is in your HTML <body>
  • Check browser console for errors

​
Submissions not received?

  • Verify form submission succeeded (check response)
  • Check spam folder for notification emails
  • Review webhook logs in dashboard

Need help?

Visit our troubleshooting guide for common issues.