FORMS · Published 2026-10-06 · Updated 2026-10-06 · SecureSMTP

Hosted forms

Build a form in the dashboard, show it on your site, and get every submission by email.

A hosted form is a form you build in the dashboard. SecureSMTP keeps its fields and settings. On WordPress the plugin shows it with a shortcode. On any other website you paste one line of code (see Show the form on any website). Every submission is stored and emailed to you.

Already have your own form? You do not need the builder. Send its submissions with the Forms API.

Build a form

  1. Open Form builder in the dashboard (/app/forms/builder) and create a form with a name.
  2. The slug is made from the name. You can change it: lowercase letters, numbers and dashes, up to 80 characters, unique in your account. The shortcode and the API use the slug.
  3. A new form starts with three fields: name, email and message. Add, remove and reorder fields. Each field has a label, a key (the name attribute), a type, a placeholder and a required switch. Keys must be unique in the form.
  4. Set the options below and click Save changes. The live preview shows the form as visitors will see it.

Field types

TypeShown in the builder asNotes
textShort text—
emailEmailUsed for Reply-To and the auto-reply.
telPhone—
urlURL—
numberNumber—
textareaLong text—
selectDropdownOptions, one per line.
checkboxCheckbox—
dateDate—
timeTime—

Field keys can be up to 60 characters and labels up to 200. In the form definition each field is stored as { name, label, type, placeholder, required, options }.

Settings

SettingKeyWhat it does
Submit button textsubmit_labelUp to 80 characters. Default “Send message”.
Success messagesuccess_messageShown after a submission. Up to 500 characters.
Notification recipientsnotify_emails, notify_emailUp to 3 addresses that get each submission. The first is required. notify_email holds the first one.
Auto-responderconfirm_enabled, confirm_from_name, confirm_subject, confirm_bodyAn email to the person who filled in the form. See below.
Brand colorbrand_colorA hex color such as #FF5500.
Corner roundnessradius_presetsharp, small, medium, large or pill.
Field backgroundfield_tonelight, subtle or dark.
Submit alignmentbutton_alignleft, center, right or block (full width).
Cardcard_wrapWrap the form in a card.

Auto-responder

When it is on, the person who filled in the form gets an email with your subject and body. It is sent only when the submission contains an email address, and never for a submission classified as spam or over the monthly limit, to a suppressed address, or to someone who unsubscribed from your site. Replies to it go to the first notification recipient. If the subject is empty, it is “Thanks — site name”.

The body can be plain text or HTML. You can use these placeholders in the subject and the body. Values typed by the visitor are HTML-escaped in the body. A placeholder that cannot be filled is left as it is.

PlaceholderReplaced with
{name}The first non-empty value of a field called name, full_name, first_name, your-name or similar; otherwise the first field whose key contains “name”.
{email}The submitter’s email address (see below).
{form_name}The form name.
{site_name}The site’s display name.
{site_domain}The site’s domain, for example example.com.
{field:KEY}The value of the field with key KEY, for example {field:phone}.

How the email address is found: the value of a field with the key email, e_mail, your-email, your_email or mail; otherwise the first value that looks like an email address. The same address becomes the Reply-To of the notification you receive.

Show the form on WordPress

Install the WordPress plugin, add the site’s API key, and put the shortcode on any page or post:

Shortcode
[securessmtp_form slug="contact"]

Pages that use the older [qcs_form slug="…"] shortcode keep working with plugin 1.23.1 or later. The plugin keeps a copy of the form for 5 minutes, so a change in the builder can take up to 5 minutes to show on your site.

Show the form on any website

On a site that is not WordPress (plain HTML, Webflow, Squarespace, Wix, Shopify, React and others) you paste one line of code. No API key goes into the page.

  1. Open the form in Form builder.
  2. In Embed on any website, pick the site the submissions belong to and click Create embed code.
  3. Copy the code and paste it where the form should appear.
Script
<script src="https://securessmtp.com/embed.js" data-form="sf_8kQ2mX9pL4rTz7Wd" async></script>

The form appears where the script tag is, in a frame that grows to fit the form. If a page builder removes script tags, use the iframe code instead. Its height is fixed, so set it to fit your form.

iframe
<iframe src="https://securessmtp.com/embed/sf_8kQ2mX9pL4rTz7Wd" title="Contact" style="width:100%;height:620px;border:0" loading="lazy"></iframe>

In React and other single-page apps, a script tag written in JSX does not run. Put a placeholder where the form goes and load https://securessmtp.com/embed.js once on the page, for example in the page head. If the placeholder appears after the script has loaded, call window.SecureSMTPForms.load().

React
<div data-securessmtp-form="sf_8kQ2mX9pL4rTz7Wd"></div>

Where to paste it

SiteWhere
Plain HTMLAnywhere in the page body.
WebflowAdd a Code Embed element and paste the script code.
SquarespaceAdd a Code block and paste the script code. If scripts do not run on your plan, use the iframe code.
WixAdd Embed code → Embed HTML, choose Website address and paste the frame address, for example https://securessmtp.com/embed/sf_8kQ2mX9pL4rTz7Wd. Wix shows pasted code inside its own frame on another address, so the code option does not work.
ShopifyIn the theme editor, add a Custom Liquid section and paste the script code.
React, Next.jsThe placeholder above, and the script loaded once on the page.

Allowed websites

The form shows only on the site’s domain and its subdomains, plus up to 5 more websites you add in the same box. On any other website the browser refuses to show it. The websites must use https. A site builder’s own address (for example name.webflow.io or name.wixsite.com) counts as another website: add it if the form should show there.

The code is not a secret. It can only show this form and send its answers to the recipients saved in the form. You can turn a code off, or make a new one (the old one then stops working). Forms that ask for passwords, card numbers, PINs or recovery phrases cannot be embedded.

What is checked

  • A Cloudflare Turnstile check in the form. Without it the submission is not taken.
  • A hidden field that bots fill in, and a minimum time between opening the page and sending.
  • At most 3 submissions a minute from one visitor; after that the visitor is blocked for an hour.
  • At most 100 submissions an hour per code. Above that, submissions are stored but not emailed.
  • The same spam score and AI check as other hosted-form submissions. When the score is unclear, the email waits for the AI answer, so spam is not emailed.
  • Recipients, From name and the auto-reply come from the saved form. The page cannot change them.
  • Auto-replies follow the same rules as for the Forms API: each new version of the text is checked (spam score, phishing signs, AI), and auto-replies have daily limits. A refused text sends no auto-replies; a text that looks like phishing pauses the site. An auto-reply is sent only after the Turnstile check passed.

Submissions are stored under the site you picked, count toward your monthly form submissions, and follow the same account rules as WordPress submissions: a confirmed account email and a verified sending domain.

When the form does not show

The frame shows “This form is not available right now.” when the code is off, the form is archived, the site is paused, or your plan does not include embedding. Opening the frame address directly in a browser tab shows a short note instead of the form.

Embedding on other websites is part of the Pro plan and higher.

Use a hosted form outside WordPress

To draw the form yourself instead, your server does the work, because both calls need the API key:

  1. Read the form with GET /forms/render/{slug}.
  2. Build the HTML from form.fields and form.settings.
  3. Let the form post to your own server.
  4. From your server, send the values to POST /forms/submit. See Forms API for a full example.
curl https://securessmtp.com/api/v1/forms/render/contact \
  -H "x-securessmtp-api-key: $SECURESSMTP_API_KEY"
Response
{
  "ok": true,
  "form": {
    "id": "6f0c2d1e-8a4b-4c3d-9e2f-1a2b3c4d5e6f",
    "name": "Contact",
    "slug": "contact",
    "fields": [
      {
        "name": "name",
        "label": "Your name",
        "type": "text",
        "required": true,
        "placeholder": "Jane Doe"
      },
      {
        "name": "email",
        "label": "Email",
        "type": "email",
        "required": true,
        "placeholder": "[email protected]"
      },
      {
        "name": "message",
        "label": "Message",
        "type": "textarea",
        "required": false,
        "placeholder": "Tell us a bit about your project"
      }
    ],
    "settings": {
      "submit_label": "Send message",
      "success_message": "Thanks. We will be in touch.",
      "notify_email": "[email protected]",
      "brand_color": "#FF5500",
      "radius_preset": "medium",
      "button_align": "left",
      "field_tone": "light",
      "card_wrap": false
    },
    "updated_at": "2026-10-07T09:30:00.000Z"
  }
}
  • The response can be cached for 60 seconds (Cache-Control: public, max-age=60).
  • POST /forms/submit does not read the saved settings. Pass the notification recipients, the from name and the auto-responder (confirm) in the request yourself.
  • form_id in POST /forms/submit must be a positive whole number. The id above is a UUID and is not accepted there, so use your own number for each form.
  • Errors: 400 invalid_slug, 404 form_not_found, 410 form_archived. See the error catalogue.

Where submissions show

  • By email. Each submission is emailed to the notification recipients with the subject “New form name submission — site domain”. Reply-To is the visitor’s email address, so you can answer straight away. If the site has no verified sending domain and the account may not use the shared address, the submission is stored but no notification is sent: the answer has email_sent: false and the submission’s email status is failed with the error domain_not_verified. See Your own domain is required.
  • In the dashboard. Submissions (/app/forms/submissions) lists every stored submission with the time, site, form, a preview, the spam class (legitimate, suspicious or spam) and the email status. You can filter by site and by class.

Spam and submissions over your plan’s monthly limit are stored too, but not emailed. See Spam protection and Plans and limits.