WordPress
Add a WordPress contact form with a Custom HTML block posting to FormsReach - no PHP mail plugin required.
What you will achieve
A contact form on a WordPress page using a Custom HTML block (or theme template) that posts to FormsReach.
Prerequisites
- A FormsReach form and API key
- Permission to edit pages (block editor) or theme templates
Steps
1. Create a form and copy the API key
Sign in at app.formsreach.com, create a form, copy the API key.
2. Add a Custom HTML block
- Edit the page where the form should appear.
- Insert a Custom HTML block (not a plain paragraph).
- Paste:
<form action="https://api.formsreach.com/submit" method="POST">
<input type="hidden" name="api_key" value="YOUR_ACCESS_KEY" />
<input type="text" name="name" required />
<input type="email" name="email" required />
<textarea name="message" required></textarea>
<button type="submit">Submit Form</button>
</form>
Replace YOUR_ACCESS_KEY with your real key.
You can also place the same markup in a child theme template or a reusable block pattern.
3. Publish and test
Publish the page, submit once from the live (or preview) URL, open Submissions.
Verify
- The form tags and
api_keyfield are still present when you view page source - Dashboard shows the test row
- Theme CSS can style the form (snippet is unstyled by design)
Common failures
| Symptom | Check |
|---|---|
| Form tags removed | Use Custom HTML, not a text paragraph; some builders strip raw HTML |
| Missing api_key | Editor stripped the hidden input - re-paste and recheck source |
| Caching oddities | Classic form POST works with most caches; avoid minifiers that strip form attributes |
| Domain denied | Add your WordPress host (and www if used) to the allowlist |
Next
- Test your form
- Email channel
- HTML guide for non-WordPress static sites
- Marketing landing: /integrations/wordpress/