Recontact — quickstart

Recontact is a contact-form backend. Drop a script into any plain HTML form and it handles submission, spam protection (Captcha + rate limiting), and email notifications. No backend or build step required.

1. Register the domain

curl -X POST -F [email protected] https://api.recontact.dev/v1/register/example.com

This creates an inbox for example.com and sends a verification email to the specified email address. The inbox can receive form submissions, but it will not send email notifications to your email until you verify your email.

2. Verify the email

Open the https://api.recontact.dev/v1/verify/<token> link from the confirmation email. Once verified, email notifications will flow.

3. Add the form and script

<form id="contact-form" action="https://api.recontact.dev/v1/nojs" method="post">
  <label>Email <input type="email" name="user_email" required /></label>
  <label>Message <textarea name="message" rows="4" required></textarea></label>
  <button type="submit">Send</button>
  <a href="https://recontact.dev">Powered by recontact.dev</a>
</form>
<script
  src="https://api.recontact.dev/v1/embed.js"
  data-domain="example.com"
  data-form-id="contact-form"
></script>
  • The action should point at the nojs link so that if the browser has JavaScript

disabled, we can still give the user a good message.

  • The Powered by recontact.dev link is required on the free plan, the script

will not activate without it.

More info

Script attributes

To learn more about the available script attributes that can help you customise your integration, see the API docs.

Behavior

  • Messages are stored and emailed to the verified notification address.
  • Free plan: unlimited messages, one weekly summary email.
  • Paid plan: immediate per-message emails.
  • Browsers with JavaScript disabled get a fallback page via /v1/nojs.