ARZS Forms Documentation

Complete guide to building, embedding, and managing forms with the ARZS platform.

Getting Started

ARZS Forms is a powerful SaaS form builder with advanced field types, validation, and captcha support. Get started in minutes with our intuitive dashboard.

Quick Start

1. Create an Account

2. Create Your First Form

Navigate to Dashboard → Forms → New Form. Use the visual form builder to add fields, configure validation, and set up notifications.

3. Deploy Your Form

Choose between hosted forms, embeddable widgets, or direct API integration.

Authentication

All API requests require JWT authentication. Include your token in the Authorization header.

Login

curl -X POST https://api.arzs.me/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your-password"
  }'

Using the Token

curl -X GET https://api.arzs.me/api/forms \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Form Builder

Create custom forms with 16+ field types, dynamic validation, and advanced features.

Creating a Form

curl -X POST https://api.arzs.me/api/forms \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contact Form",
    "description": "Get in touch with us",
    "custom_fields": [
      {
        "fieldType": "text",
        "name": "fullName",
        "label": "Full Name",
        "isRequired": true,
        "minLength": 2,
        "maxLength": 100
      },
      {
        "fieldType": "email",
        "name": "email",
        "label": "Email Address",
        "isRequired": true
      },
      {
        "fieldType": "textarea",
        "name": "message",
        "label": "Message",
        "isRequired": true,
        "minLength": 10,
        "maxLength": 1000
      }
    ],
    "mail_to": ["your-verified@email.com"],
    "captcha_type": "none"
  }'

Field Types

ARZS Forms supports 16+ field types with dynamic validation.

Text Fields

text - Single line text
email - Email with validation
tel - Phone number
password - Password field
textarea - Multi-line text

Number & Date

number - Numeric input
date - Date picker
time - Time picker
datetime-local - Date & time
range - Slider

Selection Fields

select - Dropdown
radio - Radio buttons
checkbox - Checkboxes

Other Fields

color - Color picker
month - Month selector
week - Week selector

Embedding Forms

Embed forms on your website using our widget code or use hosted pages.

Hosted Form

Every form gets a hosted page at https://api.arzs.me/form/YOUR_FORM_UUID

Widget Embed

<!-- Add this to your HTML -->
<div id="arzs-form-YOUR_FORM_UUID"></div>
<script src="https://api.arzs.me/widget.js"></script>
<script>
  ARZSForm.render('YOUR_FORM_UUID', {
    container: '#arzs-form-YOUR_FORM_UUID'
  });
</script>

API Submission

Submit forms directly via API without using the widget or hosted page.

curl -X POST https://api.arzs.me/api/submit/YOUR_FORM_UUID \
  -H "Content-Type: application/json" \
  -H "Origin: https://yourdomain.com" \
  -d '{
    "fullName": "John Doe",
    "email": "john@example.com",
    "message": "Hello, I would like to get in touch!"
  }'

Note: Field names must match the name property defined in your form's custom fields.

DownDetector

Monitor your websites and APIs 24/7 with 4 different check types.

HTTP Status Check

Validates HTTP response codes (2xx-3xx = success). Records status code and response time.

JSON Response

Parses JSON and validates values at specific paths. Perfect for API health checks.

HTML Snippet

Searches response body for specific text or HTML content to verify page integrity.

Response Time

Measures response time and marks as degraded if it exceeds your threshold.

Creating a Monitor

curl -X POST https://api.arzs.me/api/monitors \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Website Monitor",
    "url": "https://example.com",
    "check_type": "http_status",
    "check_interval": 5,
    "alert_emails": ["your-verified@email.com"]
  }'

Domain Whitelisting

Control where your forms can be embedded by whitelisting specific domains.

Auto-Whitelisted Domains

• Same-origin requests (hosted form page)
• localhost and 127.0.0.1 (for development)

Wildcard Support

Use *.example.com to allow all subdomains.

{
  "allowed_domains": [
    "example.com",
    "*.example.com",
    "another-domain.com"
  ]
}

Webhooks

Receive real-time notifications when forms are submitted by configuring webhook URLs.

Webhook Payload

{
  "event": "form.submitted",
  "form_uuid": "abc123...",
  "form_name": "Contact Form",
  "submission": {
    "fullName": "John Doe",
    "email": "john@example.com",
    "message": "Hello!"
  },
  "metadata": {
    "ip": "192.168.1.1",
    "user_agent": "Mozilla/5.0...",
    "submitted_at": "2025-11-21T08:00:00Z"
  }
}

Coming Soon: Webhook functionality is currently in development and will be available in the next release.

Captcha Integration

Protect your forms from spam with reCAPTCHA, hCaptcha, or Cloudflare Turnstile.

reCAPTCHA

Google's reCAPTCHA v2 for spam protection.

custom-recaptcha

hCaptcha

Privacy-focused alternative to reCAPTCHA.

custom-hcaptcha

Turnstile

Cloudflare's user-friendly captcha solution.

custom-turnstile

Note: All captcha providers require you to provide your own site key and secret key. Get free keys from the respective provider's website.

Need Help?

Can't find what you're looking for? We're here to help!

Contact Support

Email us at support@arzs.io

Join the Community

Connect with other developers and get help from the community.