Forms API & Form Builder
Build Forms Without Backend Code

<!-- Simple HTML contact form - no backend needed -->
<form action="https://api.sendmator.com/api/v1/forms/submit"
      method="POST">

  <!-- Your API key (get from dashboard) -->
  <input type="hidden" name="api_key" value="your-api-key">
  <input type="hidden" name="form_id" value="contact-form">

  <!-- Form fields -->
  <input type="text" name="name" placeholder="Your Name" required>
  <input type="email" name="email" placeholder="your@email.com" required>
  <textarea name="message" placeholder="Your message" required></textarea>

  <!-- Spam protection honeypot -->
  <input type="text" name="_honeypot" style="display:none">

  <button type="submit">Send Message</button>
</form>

// Response on success
{
  "success": true,
  "message": "Form submitted successfully",
  "submissionId": "sub_abc123xyz"
}
        

import { useState } from 'react';

function ContactForm() {
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    message: ''
  });
  const [status, setStatus] = useState('');

  const handleSubmit = async (e) => {
    e.preventDefault();
    setStatus('submitting');

    try {
      const response = await fetch('https://api.sendmator.com/api/v1/forms/submit', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-Key': 'your-api-key'
        },
        body: JSON.stringify({
          form_id: 'contact-form',
          ...formData
        })
      });

      const data = await response.json();

      if (data.success) {
        setStatus('success');
        setFormData({ name: '', email: '', message: '' });
      } else {
        setStatus('error');
      }
    } catch (error) {
      setStatus('error');
      console.error('Form submission error:', error);
    }
  };

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="text"
        value={formData.name}
        onChange={(e) => setFormData({...formData, name: e.target.value})}
        placeholder="Your Name"
        required
      />
      <input
        type="email"
        value={formData.email}
        onChange={(e) => setFormData({...formData, email: e.target.value})}
        placeholder="your@email.com"
        required
      />
      <textarea
        value={formData.message}
        onChange={(e) => setFormData({...formData, message: e.target.value})}
        placeholder="Your message"
        required
      />
      <button type="submit" disabled={status === 'submitting'}>
        {status === 'submitting' ? 'Sending...' : 'Send Message'}
      </button>
      {status === 'success' && <p>Thank you! We'll be in touch soon.</p>}
      {status === 'error' && <p>Oops! Something went wrong.</p>}
    </form>
  );
}
        

POST https://api.sendmator.com/api/v1/forms/submit
Content-Type: application/json
X-API-Key: your-api-key

// Submit form data via API
{
  "form_id": "contact-form",
  "name": "John Doe",
  "email": "john@example.com",
  "message": "I'm interested in your services",
  "phone": "+1234567890"
}

// Python example
import requests

response = requests.post(
    'https://api.sendmator.com/api/v1/forms/submit',
    headers={'X-API-Key': 'your-api-key'},
    json={
        'form_id': 'contact-form',
        'name': 'John Doe',
        'email': 'john@example.com',
        'message': "I'm interested in your services"
    }
)

// Node.js example
const response = await fetch('https://api.sendmator.com/api/v1/forms/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    form_id: 'contact-form',
    name: 'John Doe',
    email: 'john@example.com',
    message: "I'm interested in your services"
  })
});

const data = await response.json();
console.log(data);
        

// Configure webhook URL in dashboard
// Webhook endpoint: https://your-app.com/webhooks/form-submission

// Sendmator sends POST request to your webhook URL
POST https://your-app.com/webhooks/form-submission
Content-Type: application/json
X-Sendmator-Signature: sha256-signature-for-verification

{
  "event": "form.submitted",
  "form_id": "contact-form",
  "submission_id": "sub_abc123xyz",
  "timestamp": "2026-07-24T10:30:00Z",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "I'm interested in your services"
  },
  "meta": {
    "ip_address": "192.168.1.1",
    "user_agent": "Mozilla/5.0...",
    "referrer": "https://yoursite.com/contact"
  }
}

// Express.js webhook handler example
app.post('/webhooks/form-submission', (req, res) => {
  const { event, form_id, data } = req.body;

  if (event === 'form.submitted') {
    // Process form submission
    console.log(`New submission for ${form_id}:`, data);

    // Send to Slack, save to database, etc.
    await notifyTeam(data);
    await saveToDatabase(data);
  }

  res.json({ received: true });
});