How do I reply to the person?

Set the email's reply-to to the submitter's email (FormLoom does this automatically when an `email` field is present).

Do I need the json-enc extension?

Yes, to send a JSON body. Without it htmx sends form-urlencoded, which FormLoom also accepts.

How do I show the response?

Use `hx-swap` to replace the form (or a target) with FormLoom's response.

htmx contact form

The classic name / email / message form. The default for any site's contact page.

Recommended fields

Field	Type	Required
name	text	Yes
email	email	Yes
message	textarea	Yes

The code

Use `hx-post`, `hx-ext="json-enc"`, and an `hx-headers` attribute for `Accept: application/json`. Swap the response into the page.

htmx (hx-post + json-enc)

contact.html

<!-- Include htmx + the json-enc extension -->
<form
  hx-post="https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY"
  hx-ext="json-enc"
  hx-swap="outerHTML"
  hx-headers='{"Accept": "application/json"}'
>
  <label>
    Name
    <input type="text" name="name" required />
  </label>
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <label>
    Message
    <textarea name="message" required placeholder="How can we help?"></textarea>
  </label>
  <!-- honeypot: bots fill this, humans don't see it -->
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
  <button type="submit">Send</button>
</form>

Plain HTML (no JavaScript)

contact.html

<form action="https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY" method="POST">
  <label>
    Name
    <input type="text" name="name" required />
  </label>
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <label>
    Message
    <textarea name="message" required placeholder="How can we help?"></textarea>
  </label>
  <!-- honeypot: bots fill this, humans don't see it -->
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
  <button type="submit">Send</button>
</form>

@formloom/client (typed SDK)

submit.ts

// npm i @formloom/client
import { createForm } from "@formloom/client";

type Contact = {
  name: string;
  email: string;
  message: string;
};

const form = createForm<Contact>("YOUR_ACCESS_KEY");

// End-to-end typed: TS errors if you send the wrong shape.
const { success, message } = await form.submit({
  name: form.name.value,
  email: form.email.value,
  message: form.message.value,
});

Tips

Add a hidden `redirect` to a thank-you page so visitors get clear feedback.
Set a `subject` field so the notification email is easy to triage.

FAQ

Name, email, and message cover most cases. Keep it short — every extra field lowers completion.