Forms & Submissions

Creating a form

1. Open a workspace in your dashboard.
2. Click New Form (+).
3. Give it a name (e.g., “Contact Form”, “Newsletter Signup”).
4. Copy the Form ID displayed at the top of the form page.

Use this Form ID to construct your form’s action URL (https://app.formtress.com/api/f/your-form-id) or pass it to the submitForm() function.

Field types

Type	Stored value
text, number, email, tel, url, date, textarea, select, radio, file	The submitted value as-is.
checkbox	true or false.
checkboxGroup	Comma-joined selections, e.g. "Web,Design,SEO".

Checkbox groups let users select multiple options (e.g. “Which projects do you need help with?”). Configure the choices in the field settings, one option per line. In your form markup, every option is a checkbox sharing the same name, each with its own value:

<label><input type="checkbox" name="Projects" value="Web" /> Web</label>
<label><input type="checkbox" name="Projects" value="Design" /> Design</label>
<label><input type="checkbox" name="Projects" value="SEO" /> SEO</label>

A submission with Web and SEO checked is stored as Projects: "Web,SEO". A checkbox field, by contrast, is a single toggle (like “I agree to the terms”) and is always stored as a boolean.

Note: If a plain checkbox field receives checkbox-group-style markup (several inputs sharing the name with explicit value attributes), Formtress stores the selections comma-joined anyway, so you never lose data. Use the checkboxGroup type to also get required-field enforcement (“at least one selection”) and per-option analytics.

Viewing submissions

Each form has a submissions table showing:

• All submitted field values
• Timestamp
• Spam/clean status through tabs
• Integration delivery status

You can filter, search, and sort submissions from the dashboard. You can also reorder, hide, and pin columns, and export submissions as CSV.

Testing & debugging

To send test submissions, add ?test=true to your form ID. Test submissions are placed under the Test tab in the submissions table. They are not processed by integrations and they don’t count towards your submission limits. This allows you to safely test your form setup without triggering emails or webhooks. Test submissions are also deleted after 7 days.

Spam management

Formtress validates submissions against your validation rules after going through general spam checks. Submissions that fail validation are flagged as spam but still stored, so you never lose data.

Reviewing spam

• Flagged submissions are marked in the submissions table under the Spam tab.
• You can review any flagged submission and mark it as clean if it was incorrectly caught.
• Marking a submission as clean will make it available for integration re-triggers.

Re-triggering integrations

If a submission was flagged as spam but is actually legitimate, you can:

1. Select the submission.
2. Click the 3-dot menu in the top right.
3. Choose Mark as Clean and it will automatically trigger integrations.

This is also useful if an integration was temporarily down and you need to re-send clean submissions.