WP Manifestindependent plugin directory
manifest / forms / wordpress-headless-forms

Headless Forms

production-ready WordPress plugin for headless form submissions. The plugin provides a secure REST API, 16 email providers, webhooks, GDPR compliance, and a modern admin interface.

by Danish Mohammed · github.com/danishfareed/wordpress-headless-forms · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/danishfareed/wordpress-headless-forms/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/danishfareed/wordpress-headless-forms ↗

Headless Forms for WordPress

Headless Forms is a powerful REST API form handler designed specifically for headless WordPress architectures. Accept form submissions from React, Next.js, Vue, Astro, or any modern frontend with ease and security.

✨ Key Features

  • 🚀 Secure REST API – API key authentication with rate limiting.
  • 📧 16+ Email Providers – Native support for AWS SES, SendGrid, Resend, Mailgun, Postmark, and more.
  • 🔌 Webhook Integrations – Connect to Zapier, Google Sheets, Slack, and Make.
  • 🛡️ Spam Protection – Built-in honeypot fields and IP-based rate limiting.
  • 🔒 GDPR Ready – Tools for data export, deletion, and automatic retention policies.
  • 📊 Modern Admin Dashboard – Futuristic UI (Purple/Orange themed) with submission analytics.
  • 📨 Auto-Responders – Send customized confirmation emails to your users.
  • 📜 Email Logs – Comprehensive tracking of all outgoing emails with unique Message IDs.

🚀 Quick Start

1. Installation

  1. Clone this repository into your wp-content/plugins/ directory.
  2. Activate the plugin in your WordPress Admin.
  3. Go to Headless Forms > Settings to get your API Key.

2. Frontend Integration

Submit your forms to: POST /wp-json/headless-forms/v1/submit/{form-slug}

fetch('https://yoursite.com/wp-json/headless-forms/v1/submit/contact-us', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-HF-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    name: 'John Doe',
    email: 'john@example.com',
    message: 'Hello from the headless frontend!',
    _honey: '' // Ensure this hidden honeypot field is empty
  })
});

🛠 Supported Email Providers

Headless Forms supports a wide range of transactional email services out of the box:

  • AWS SES (with Bounce/Delivery tracking)
  • SendGrid, Resend, Mailgun, Postmark
  • Brevo, Mailjet, Postmark, SparkPost
  • SMTP, WP Mail (Internal)

🎨 Modern Dashboard

The plugin features a futuristic, premium UI inspired by modern performance plugins, providing:

  • Real-time submission analytics.
  • Integration management.
  • Detailed email delivery logs.
  • Easy-to-use form configuration.

📄 License

This project is licensed under the GNU General Public License v2 or later.

👨‍💻 Created By

Danish Mohammed - Professional WordPress & Headless Developer.