Formcask

Quick start

  1. Sign up and copy your API key from the dashboard.
  2. Create a workspace, then a form (or POST /api/forms).
  3. Paste the snippet, replacing the form id.

Copy-paste HTML

<form action="https://formcask.com/f/f_YOUR_FORM_ID" method="POST">
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <textarea name="message"></textarea>
  <input type="text" name="_gotcha" style="display:none" tabindex="-1" autocomplete="off">
  <button type="submit">Send</button>
</form>

Accepted content types

application/x-www-form-urlencoded, application/json, and multipart/form-data (files on Pro and Agency, up to 5MB and 5 per request).

Spam: a filled _gotcha field is stored as spam and is not emailed or sent to your webhook. Each form is rate limited to 10 posts per minute per IP.

After submit: set a default redirect on the form, or pass _redirect (http or https only). JSON/AJAX clients get {"ok":true} instead.

Plans

Free includes email notifications and 250 submissions/month on one workspace. Webhooks, file uploads, and extra workspaces require Pro ($12/mo) or Agency ($29/mo).

Webhooks (Pro and Agency)

We POST JSON with headers X-Webhook-Timestamp and X-Webhook-Signature: sha256=<hex>. The signature is HMAC-SHA256 of timestamp + "." + raw body using the form's webhook secret. Failed deliveries retry up to 5 times.

API