Documentation

Getting started

Step 1 - Sign up and get your key

If you haven't already, sign up for an account with us. Once you are logged in, you will land on the "Forms" page with one Form ready to go.

You'll see a key field like this, which is how we will link your form submissions to your email address. You don't need to copy this at this stage.

Key

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Step 2 - Verify your email addresses

To be able to send you emails, we need to verify the email address on your Account and on each Form. We send you a verification email when you sign up, but if you need to send it again, you can do so from the "Forms" page.

Your email isn't verified

You must verify your email address before we can process any data, please check your inbox.

Step 3 - Create your first form

The quickest way to get up and running is to go to your Form, fill in your desired settings and click the button at the bottom which generates your base HTML form for you.

You can also quickly test your form by clicking on the . This is especially useful for checking you have your Captcha or redirect set up correctly.

Step 4 - Install it on your website

Copy and past this into your website and you should now have a fully operational form that will now post the forms data directly to your inbox!

Manually

If you wish to build your own form from scratch or make API calls directly, no problem! You can do so using the following url endpoint:

Warning

This endpoint only accepts POST data with the following header types: application/x-www-form-urlencoded or application/json

Example

Step 5 - Test it out

Boot up your website, fill in your new form and send yourself an email!

Step 6 - Customise it

You can now edit the form however you wish, and if it posts legitimate data, we'll relay this to your inbox or show an error page.

You can also add a custom redirect to a handcrafted thank you page or add recaptcha for extra protection.

API

The same end point will accept and return json if you wish to make calls directly to our API.

Example in Javascript:

Warning

Ensure to POST your data and set the header Content-Type to application/json. . Otherwise you're going to have a bad time.

Set up a reCaptcha

Google reCaptcha

Website

Google reCAPTCHA is a free service that protects your site from spam and abuse. It uses advanced risk analysis techniques to tell humans and bots apart.

What you will need

  • You will need a google account, sign in or you can create a new account for free.
  • Your Google reCaptcha site and secret keys
  • Access to the website you want to embed your form into

Get your V3 site and secret keys

Once you have a Google account, you can set up a new reCaptcha site.

Follow their instructions, selecting reCAPTCHA type V3 and make sure you fill in the domains correctly.

Warning

Please make sure to add both your own domain and 'staticcontact.com' to your whitelisted domains.

Hit save and you should be presented with your very own reCAPTCHA key and secret.

What to do with your site and secret keys?

You need to copy the keys to Static contact so that we can manage the verification calls with Google on your behalf.

SITE KEY: Your client side, 'Site Key' is for public use only, and will need to be added to your forms submit button to make it work.

From Google Recaptcha, copy your Site Key, then in Static Contact, find the Form you want to add reCaptcha to, and click the "Captcha" drop down, select Google reCaptcha, and then paste the key into the 'Site Key' field. Now return to the Google recaptcha website to get your Secret Key.

SECRET KEY: Your Secret Key is for back-end code only.

In Google Recaptcha, copy your Secret Key, return to Static Contact, find the Form you are adding captcha to, and paste the key into the 'Secret Key' field.

Once both fields have your keys in them, click the and test your form by clicking on the to make sure you are getting no errors.

Then simply click the on the same form. This will now generate you a Google reCapthca ready form which you can copy and paste into your website.

Load your website in a browser and you should see the reCaptcha logo load on your site, and your form should now be protected by Google reCaptcha and be relaying through Static contact to your inbox.

Docs

Documentation

Example

hCaptcha

Website

Solve your fraud and abuse problem today. Instantly detect and deter human and automated threats.

What you will need

Get your Site and Secret keys, and what to do with them

SITE KEY: Your client side, 'Site Key' is for public use only, and will need to be added to your form to make it work.

Log into hCaptcha and you will be presented with the hCaptcha Dashboard, look for the "add site" button halfway down the page.

Fill in the form details, making sure to add the correct details.

Warning

Please make sure to add both your own domain and 'staticcontact.com' to your whitelisted domains.

You will now see a list of your hCaptcha instances, clicking on one will allow you to get your first 'Site key', which is a unique public ID you use on your site or app.

Copy this key and head back to Static Contact, find the Form you want to add hCaptcha to, and select 'hCaptcha' from the 'Captcha' dropdown, paste your Site Key into the 'Site Key' field.

SECRET KEY: Your server side, 'Secret Key' is backend use only, and will need to be added to your Static Contact Form to make it work.

In hCaptcha, click on your profile icon, top right, and select 'Settings'.

Your top item should be an account level secret - generate one if you don't have one already, and copy the code.

In Static Contact, find your Form and paste the 'Secret key' into the matching 'Secret key' field.

Click and test your form by clicking on the to make sure you are getting no errors.

Once you are happy with it, simply click the on the same form. This will now generate you a hCaptcha ready form which you can copy and paste into your website.

Load your website in a browser and you should see hCaptcha load on your site's form, which should now be protected by hCaptcha.

Docs

Documentation

Example

© 2024 Static Contact. All rights reserved.