Creating a form
- Go to Dashboard → Forms → click New Form.
- Enter a name that identifies where the form is (e.g. "Homepage Contact", "Landing Page A").
- Your form is created instantly with a unique API key.
Using your form key
Add these two changes to any existing HTML form:
<!-- 1. Change the action to our endpoint -->
<form action="https://formstodb.com/api/submit" method="POST">
<!-- 2. Add your key as a hidden field -->
<input type="hidden" name="_key" value="YOUR_FORM_KEY">
<!-- Your fields (all captured automatically) -->
<input type="text" name="name">
<input type="email" name="email">
<input type="tel" name="phone">
<button type="submit">Send</button>
</form>
FormsToDB captures all field names automatically — name, email, phone, message, or any custom fields. No configuration needed.
Special field names
These field names get special treatment in your dashboard:
name— displayed as the lead's nameemail— enables the Email action buttonphone— enables WhatsApp and Call buttonsmessage— shown in the lead detail panel
AJAX / JavaScript forms
To submit without a page reload, use fetch:
const form = document.getElementById('myForm');
form.addEventListener('submit', async (e) => {
e.preventDefault();
const data = new FormData(form);
const res = await fetch('https://formstodb.com/api/submit', {
method: 'POST',
body: data
});
const json = await res.json();
if (json.ok) showSuccess();
});
Enabling email notifications
On each form card in your dashboard, toggle Email notify on. You'll receive an email to your account address every time a new lead is submitted through that form.
Regenerating your API key
If your key is compromised, go to Forms → click the form → Regenerate key. Your old key stops working immediately. Update your HTML form with the new key.
Regenerating a key invalidates the old one instantly. Any form still using the old key will return a 401 error.